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AboM tbis Manual 


The CPMS/SYSD Installation Manual provides instructions for installing CPMS/SYSD, 
discusses issues you need to consider when operating SYSD, describes the commands the 
administrator uses to control the system, and describes the batch work file utility. It also 
provides instructions for installing the SYSD/JFT (Job and File Tailoring) option. 

This manual is used by the CICS systems programmer who installs and maintains 
CPMS/SYSD and the person who administers the system* 
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IX 



About this Manual 


Manual Organization 

The CPMS/SYSD Installation Manual is organized as follows. 



Chapter Introduction 

Introduces CPMS/SYSD and explains the differences between the two products. It also 
introduces the two options for GPMS/SYSD—^SYSD/JFT 0ob and File Tailoring) and 
SYSD/ATP (Access to GA-Panvalet). 


Chapter 2,, Installing CPMS/SYSD 

Provides instructions for installing CPMS/SYSD and testing the installation. 


Chapter 3^ Operational Considerations 

Discusses some issues you need to consider when operating CPMS/SYSD, including 
setting up basic and advanced security; maintaining user profiles; using the MVS Spool 
Display facility for JES2; using FCBs with spool print; interacting with.CICS, MVS, and 
JES2; using the editor; and using SYSD/ATP 


Chapter 4, Administering CPMS/SYSD 

Describes the commands the CPMS/SYSD administrator uses to control the system. 



Chapter 5, Batch Work File Utility 

Describes the Batch Work File utility that lets you control the SYSD work file from the 
batch environment. 


Chapter 6, Installing SYSD/JFT 

Provides instructions for installing SYSD/JFT, the Job and File Tailoring option for both 
CPMS and SYSD. 


Appendix A, STAGE1 Parameters 

Describes the parameters in SYSD.USRLIB(STAGEl) you use to define JCL parameters 
and dataset names. 


Appendix B, SYSDSETS Parameters 

Describes the parameters in SYSD.USRLIB(SYSDSETS) you use to set CPMS/SYSD's 
installation-dependent options. 
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Appendix Q PTBLMAiN Parameters 

Describes the parameters for the $PTBL macro you use to define the terminals users will 
print to. 

Appendix D, iNITMAJN Parameters 

Describes how to change GPMS/SYSD's default security level and disable selected 
functions. 


Appendix f, SYSD.USRUB Members 

Lists the members in SYSD.USRLIB you use to set options, submit installation jobs, and 
tailor GPMS/SYSD through user exits. 


Appendix F, Editor and Browse Work Files 

Describes how to define the SYSD editor work, files and the SYSD/ATP browse work files. 


Appendix G, Summary of Program Modules 

Lists GPMS/SYSD's program modules, describes their functions, and identifies the 
operating environments they run in. 


Appendix Fi, System Abends and Error Codes 

Lists the GIGS and system abends, briefly describes them, and provides corrective actions 
for each one. 
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Conventions 


The CPMS/SYSD Installation Majiual uses the following conventions. 


Text and Keyboard Conventions 


This kind ofi tiext Identifies 


BOLD bold; Commands and text you type. Uppercase bold text represents 

information you must type exactly as it appears. Lowercase bold 
text represents information you must substitute with the 
appropriate text. For example, when you see ddname in an 
instruction, type the appropriate DDNAME. 

italic Field names, manual titles, and system messages. It is also used to 

introduce new words. 


[parameter] 


An optional parameter in a command format. 


parmi |parm2 An either/or situation in a command format. You can specify one 

parameter or the other, but not both. 

A parameter in a command format you can repeat 

Enter Special keys on the keyboard you press. The example here 

represents the Enter key. 


Symbol Conventions 


This symbol! 

Identifies 

> 

Instructions for performing special functions.. 

a 

Steps in the installation instructions. The box lets you check off 
when you have completed a step. 

1 Note 

Additional information that may be of value. 
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This symboli Identifies 



Tips or suggestions about using a particular feature. 


Caution 



Important information you need to know about a feature or 
procedure. 
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Related Publications 

For more information, see the following publications;: 

H&W manuals 

♦ CPMS/SYSD Reference Manual 

♦ SYSD/JFT Reference Manual 

IBM manuals 

♦ CICS System Programmer's Manual 

♦ MVS Systems Programming Library: Data Management 

♦ OS/MVS Systems Programming Library: Job Management 


xtv 
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Chapter t 

iMroductibn 


GPMS/SYSD is a powerful set of GIGS tools that lets you do everything from display the 
spool and control GIGS printers to develop and debug application programs. GPMS/SYSD 
can increase the productivity of everyone in your IS department: GPMS/SYSD lets: 

♦ Application programmers use the ISPF-like editor and debugging facilities to 
develop and test online and batch programs, 

♦ Systems programmers use the GIGS management facilities to display the status of 
GIGS and dynamically change the GIGS tables. They can also use the GORE 
functional command to dynamically display and change memory. 

♦ Gomputer operators reply to outstanding operator requests and monitor the status 
of GIGS. 

♦ Data control personnel submit jobs, display the output before printing, and control 
their GIGS printers. 

♦ End users display and change batch JCL, submit jobs, and display and/or route the 
output. 

In short, GPMS/SYSD provides features that were previously available only with a 
combination of separate packages—or not at all You can dynamically control the 
operating environment, perform dataset utilities, develop programs, and view and print 
reports^—^all in real time and all under GIGS. 

This chapter explains the difference between SYSD and CPMS. It also introduces the two 
options for GPMS/SYSD-—SYSD/JFT (Job and File Tailoring) and SYSD/ATP (Access to 
GA-Panvalet). 
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Chapter 1 — Introduction 


SYSD 


SYSD lets you submit batch jobs, develop programs, and display and maintain MVS and 
GIGS. SYSD includes the spool display and GIGS printer management facilities of GPMS 
as well as:: 

♦ ISPF-like editor and browse facility 

♦ DASD and dataset management facilities 

♦ GIGS internals management facilities 

♦ GIGS debugging aids 

ISPF-like Editor and Browse Facility 

SYSD's ISPF-like editor lets you create and update PDS members and sequential datasets 
in real time under GIGS. An optional SYSD/ATP (Access to GA-Panvalet) interface lets you 
edit and browse GA-Panvalet members as well. 

SYSD uses a unique work file concept that provides security, recovery, and other benefits. 
You can:; 


♦ Work.on a PDS member or sequential dataset without updating the original until 
you are ready. 

♦ Greate temporary sessions where you can change and submit JGL without changing 
the base member. 

♦ Edit existing PDS members or sequential datasets, create new ones, or cutand paste 
data from several source datasets. 


DASD and Dataset Management Facilities 

SYSD makes it easy to manage your OS DASD datasets. SYSD includes most of the 
lEHLIST and lEHPROGM commands online. You can quickly list VTOCs and PDSs; find, 
scratch, and rename datasets; and more. 


CICS Internals Management Facilities 

SYSD provides two important facilities for managing GIGS. You can monitor GIGS activity 
and change GIGS while it is executing. This offers greater control and less down time for 
your GIGS system. 
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( : With SYSD, you can display general statistics or concentrate on particular areas in CICS. 

'W'' Por example, the STAT command gives you a snapshot of the status of CICS including the 

number of transactions processed, associated limits, number of times the limits have been 
reached, dynamic storage area (DSA) usage, temporary storage usage, and current task 
usage. Other SYSD commands display and dynamically change the status of CICS tables. 
You can display summary statistics or display a table entry in details 


CICS Debugging Aids 

SYSD provides several debugging aids that let application programmers do things like 
display and change memory and survey internal CICS information. These debugging 
aids help speed up the development process. 
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CPMS 

GPMS is a subset of the full SYSD product. GPMS includes the GIGS spool display and 
printer management facilities. With GPMS, you can follow your work through the system 
from start to finish. GPMS lets you:: 

♦ Perform limited job submission. 

♦ Display the status of active jobs. 

♦ Display a special condition code summary to see if your job ran successfully. 

♦ Display a selection menu of print outputfor viewing. 

♦ View a specific report. 

♦ Search for character strings to see specific information. 

♦ View the console log. 

After viewing your job output, you can use GPMS to control its final disposition. GPMS 
lets you:; 

♦ Print all or part of the output on any GIGS printer using the GPMS Spool Print 
facility. 

♦ Route the output to a standard local or remote JES printer or to a GPMS-controlled 
hot writer. 

♦ Gontrol GIGS or JES2 printers to handle forms changes, restarts, repeats, and so on. 

♦ Purge the output. 


Spool Print Facility 

GPMS provides a command that lets you route a job's output to a GIGS printer. If the 
printer is busy, GPMS queues the output for printing when the printer becomes available. 
Once printing starts, GPMS provides commands that let you: defer, restart, skip the 
current dataset, or terminate the dataset output. 

The Spool Print facility leaves output on the JES spool. You can print each job as many 
times as you like or issue a command to delete the job from the spool. 


Hot Writer and JOE Writer 

The hot writer and JOB writer automatically print your job's output on a GIGS printer. 
Once started, these writers periodically scan the JES output queue for jobs thatmeetyour 
criteria and print them. You can issue commands to control the printing while your job is 
active. When your job is done printing, the hot writer or JOE writer purges itfrom the JES 
spool or optionally routes it to a new destination or class. 
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The hot writer continues scanning the queue until you; shut down CPMS or CI€S, issue 
the PS (Print Stop) command, or stop the printer from Option 7 , GPMS Printer Table 
Display/Change. The JOE writer continues scanning the queue until you shut down 
CPMS or CICS, issue the STPWTR (Stop JOE writer) command, or stop the printer from 
Option 7, CPMS Printer Table Display/Ghange. 


u 
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SYSD/JFT 

SySD/(JFT (Job and File Tailoring) is an option for both CPMS and SYSD. You can use JFT 
to: 

♦ Let users submit jobs that create reports. 

♦ Build simple data entry screens that create files for batch processing. 

♦ Let programmers automate or simplify the process of submitting batch utility jobs. 
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SYSD/ATP 

SYSD/ATP (Access to GA-Panvalet) provides an interface to Computer Associates' 
CA-Panvalet datasets. The SYSD/ATP option lets users and programmers use the SYSD 
browse and edit functions to review and update GA-Panvalet libraries. 
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This chapter provides instructions forinstalling CPMS/SYSD and testing the installationi 
Before you begin, read through the instructions to preview the process. With a few noted 
exceptions, complete the steps in the order given. Most steps apply to installing both 
CPMS and SYSD. Steps that only apply to installing SYSD are marked with (SYSD only). 
Exceptions for SYSD/JFT, SYSD/ATP, and JES and OS dependencies are similarly marked. 
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Installation Checklist 

Use the following checklist to keep track of your progress; 

Step 1: Unteading the Distribution^ Libraries 

□’ A. Check the distribution cartridge 

□ ■ B. Obtain the JGL to unload the cartridge 

C. Unload the distribution libraries 

□ D. Unload the JFT libraries (SYSD/JFT only) 


Step 2: Updating the Parameters and Options 

A. Update STAGEl 
□i B. Update SYSDSETS 
C. Update PTBLMAIN 

□ D. Update and run STGIASM 

E. Update the security exits (existing customers only) 

Step 3: Preparing OS 

□i A. Authorize SYSD.LOADLIB 
□i B. RunINSTSVC 

C. Update the subsystem interface entry 

□ D. IPL the operating system 

Step 4: Preparing for Assemblies 

□I A.RunINSTCOPY 
U' B. Run INSTPROC 

Step 5: Assembling all Programs (if required) 

□' A. Run INSTMAPS 
a- B. Run INSTPROG 


TO 


CPMS®iSYSD^ - Release 6.4.2 




Chapter 2 — Installing CPMS/SYSD 






Step 6: Assembling Selfected Programs 

□ A.RunINSTCCDMM 
BlRiinlNSTCICS 

□ C. Run INSTJES2 

□ D.RunlNSTOS 

Step 7: Installing the SYSD/ATP Option: (SYSD Only) 

□ RunINSTATP 

Step 8: Updating CICS Tables 

□ A. Verify the GIGS requirements 

□ B. RUn INSTGTBL 

□ C. Update DFHAUPLK or DFHAUPLE 

□ D. Update and Assemble the DGT 

□ E. Update and Assemble the FGT 

□ F. Update and Assemble the Startup PLT (Optional) 

□ G. Update and Assemble the Shutdown PLT (Optional) 

□ H. Run INSTUGSD to Update the CSD' 

□ I. Run INSTGSD to Migrate SYSD Resources to Your GSD 

□ J. Assemble the PPT 

□ ■ K. Assemble the PGT 

Stepi9: Creating SYSD Files 

□ RunINSTFILE 

Step liO: Updating CICS JCL 

□ A. Update GIGS STEPLIB: 

□ s B; Update the CICS DFHRPL 

□ C.AddSYSDUSERDD Statement 
D. Add SYSDWRKO DD Statement 

□i E. Add SYSDIRDR DD Statement 
□1 F. Add SYSDBRSODD Statement 
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Step Hi: Testing tlie Installation) 

□ A. Execute CICS 

□ B. Perform SYSDTEST 

Step 12: Initiatiizing the Work Files 

□ A. Perform EDITINTT for SYSDWRKO (SYSD only) 

□ ^ B; Perform EDITINIT for SYSDBRSO (SYSD/ATP only) 

Step 13: Setting Up the Initial) User Profiles 

Step 14: Customizing the Security Exits (New Customers Only) 
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Installation Procedure 

Before you begin) read through the instructions to preview the process. With a few noted 
exceptions, complete the steps in the order given. Most steps apply to installing both 
CPMS and SYSD. Steps that only apply to installing SYSD are marked with (SYSD only). 
Exceptions for SYSD/JFX SYSD/ATB and JES and OS dependencies are similarly marked. 


Step 1: UnloAding the Distribution Libraries 

O A. Check the distribution cartridge 

Check the distribution cartridge to make sure it is the product you are expecting. If it is 
not, call'H&W Customer Support immediately. Your distribution cartridge should be 
labeled as follows: 

Product Name 


Labeled 

If yow received! 

CPMS 

The CICS Print Management System 

SYSD 

The fuirCICS-based Development, Print Management and Utilities 
System-(includes CPMS) 

SYSD/ATP 

SYSD with the SYSD/ATP option that interfaces with CA^Panvalet 
libraries 

If you ordered the JFT option, you should also have a cartridge labeled as follows: 

Labeled! 

If you received! 

SYSD/JFT 

The Job and File Tailoring Option for CMPS and SYSD' 

istribution Files 

The distribution cartridge contains the following standarddabel files:: 


Air of these files were created by lEBCOPY. You can change the block:sizes 
to fit your disk and environment standards. 
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Pii^' 

BSNAME 

DSNAME oni disk. 

Attfiibutes 

onidisk 

Contents 

1 i 

FILEOl 

(your JCL PDS) 



Unload cartridge JCL 

2 

EILE02 

SYSD.LOADLIB 

8368 

U 

Load library 

3 1 

FILE03 

SYSD.USRLIB 

80X6160 

FBi 

User library 

4 ! 

FILE04 

SYSDBOLfRCE 

80 X 6160 

FB) 

Source programs 

5 

FILE05 

SYSD:MACLIB 

80 X6160 

FB 

Macro library 

6' 

i 

FILE06 

SYSD.MAPLIB 

80X4080 

FB 

Map library 

7 ^ 

FILE07 

SYSD.HELP 

80 X 6160 

FB 

Help library 


□ B. obtain the JCL to unload the cartridge 

Create and run the following JGL: 


Caution 



[Make sure you change the SYSUT2 dataset to the library where your JGL resides. 



//SYSDUNLD JOB (your job parameters) 
/>GET EXEC PGM=IEBCOPY 
//SYSPRINT DD SYSOUT=A 
/j^SYSUTI DD DSN=FILE01, 

// UNIT=CART,VOL=SER=HWTAPE, 

// DISP=OLD,.LABEL=(01,SL) 

/^SYSUT2 DD DISP=SHR, 

// DSN=your.JcL.Iibrary 

/kSYSUT3 DD UNIT=SYSDA,SPACE = (TRK,,(1 ,1)) 
//SYSUT4 DD UNIT=SYSDA,SPACE=(TRK,{:1 ,1)) 
//SYSIN DD * 

COPY 0UTDD=SYSUT2,INDD=SYSUT1 

S M=UNLDSYSD 

// 


□ C. Uhibad the distribution libraries 

Upliate the JCL in the UNLDSYSD rnernber you retrieved in/'Step B; Obtain the JCL to 
unload the cartridge" to reflect your company's environment. Execute the JCL to unload 
the distribution libraries from.cartridge to disk. 
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The JCCL creates the following libraries:: 


Wis library 

Contains 

SYSDjHELP 

The online help. 

SYSD.LQADLIB 

The load library the CPMS/SYSD programs are executed from. 

SYSD.MACLIB 

The macros used in the programs. 

SYSD.MAPLIB 

The BMS map DSECTs. 

SYSD.SOURCE 

The source programs. 

SYSD:USRLIB 

The user modules, SYSD exits, members with options you can 
update, and jobs created in the installation process. 


□ D. Unload the JFT libraries (SYSD/JFT only) 

If you are also installing the SYSD/JFT option, see Chapter 6, Installing SYSD/JFT, for 
instructions on unloading the JFT libraries. 

’'w' 

step 2: Updating the Parameters and Options 

□ A. Update STAGE1 

Update the parameters in SYSD.USRLIB(STAGEl) to reflect your dataset names and JCL 
parameters. See Appendix A, STAGEl Parameters, for more information about the 
parameters. 

□ B. Update SYSDSETS 

Update the parameters in SYSD.USRLIB(SYSDSETS) to define your operating 
environment to CPMS/SYSD and tailor the product. See Appendix B^ SYSDSETS 
Parameters, for more information about the parameters. 

□ C. Update PTBLMAIN 

The parameters in SYSD.USRLIB(PTBLMAIN) define the characteristics of each CICS 
printer. CPMS/SYSD only writes to printers defined in this table. If you are installing the 
JES portion of the product and will be using the print features, update PTBLMAIN to 
define your CICS printers. See Appendix C, PTBLM/UN Parameters, for more information 
about the parameters. 
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You can update PTBLMAIN later by making the changes and reassembling the module in 
SYSD.SOURCE(SYSDPTBL). PTBLMAIN contains the printer definitions that are copied 
to SYSDPTBL when you assemble it 

O D. Update arid run STGTASM 

Update the dataset names and assembly program in SYSD;USRLIB(STG1ASM) to reflect 
your environment Then run STGIASM to create the following members in 
SYSD.USRLIBi 


This member 

Contains 

INSTATP 

The procedure that installs the SYSD/ATP option. 

INSTCieS 

The assemblies that are dependent on the GIGS version you are 
running. 

INSTCOMM 

The assemblies that are common to all environments. 

INSTCOPY 

The procedure that renames the programs that are dependent on 
the GIGS version you are running. 

INSTCSD 

The procedure that installs SYSD's PGT and PPT entries in your 
GIGS system definition file (DFHGSD). (GIGS version 2.1.2 and 
below) 

INSTGTBL 

The procedure that creates the GIGS table update copy members. 

INSTFILE 

The procedure that generates the GPMS/SYSD user file and, 
optionally, the SYSD editor and SYSD/ATP work files. 

INSTJES2 

The assemblies that are dependent on the JES2 version you are 
running. 

INSTMAPS 

The assemblies for all the maps. 

INSTPROC 

The procedure that creates the GPMS/SYSD JCL procedures. 

INSTPROG 

The assemblies for all the programs. 

INSTSVG 

The procedure that installs the GPMS/SYSD SVC. 


(continued) 
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This member Contains 

INSTUCSD The procedure that updates the GSD for CICS version 3.1 and 
above. 

INSTOS The assemblies that are dependent on the M¥S version you! are 

running. 

These members contain jobs that are tailored to your environment using the parameters 
you specified in SYSD.USRLIB(STAGEl) and SYSD.USRLIB(SYSDSETS) . This manual 
refers to these members collectively as stage 2 processing, 

O E. update the security exits 

New customers should implement the security exits as distributed and look at additional 
security after the initial installation is successful. 

If your current security exits are running in CPMS/SYSD Release 6.4.1, no changes are 
necessary. Copy the exits fromiyour 6.4.1 USRLIB to the 6.4.2 USRLIBj 

If your current security exits are running in CPMS/SYSD Release’6.3 or 6.4.0, H&W has 
provided additional information in TWA fields and through the use of the CICSGMD^ 
macro. This information allows you to replace any EXEC CICS statements that required 
you to manually copy your exits into the SYSD0074 source because of the translator. 
Compare your current security exits with the new examples in the corresponding exit 
programs to take advantage of the new facilities. 

If your current security exits are running in CPMS/SYSD releases prior to 6.3 or from.CICS 
1.7 or 2.1, then you may want to delay implementing your security exits until after the 
initial installation is successfiili, 



step 3: Preparing OS 



To complete this step, you must work with your OS systems programmers. 
You may also need to schedule a system IPL. You can complete the rest of 
the installation before you complete this step. 


□ A. Authorize SYSD.LOADLIB 

Since SYSD;LOADLIB is putin the CICS STEPLIB) you: must authorize it by updating 
SYSl.PARMLIB(IEAAPFxx) or SYSl.PARMLIB(PROGxx). 

If the SETPROG command is available, you can authorize the library by issuing the 
SETPROG APF,ADD>DSNAME=xxx,VOEUME=yyy command. In an OS/390 
environment, you can dynamically authorize the library by updating 
SYSl.PARMLIB(PROGxx) and issuing the SET PROG!=xx command on the operator 
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console. If you are able to dynamically authorize the library, you may be able to eliminate 
the need to IPL. 

If you do not want to authorize the SYSD load library, you must put the 
SYSDOSTK, SYSDGOPY, SYSDPRJMT, and SYSDPVTG programs in an 
APF-authorized library. If you are installing the SYSD/ATPdption, you 
must put the SYSDATPM and SYSDATPl programs in an APF-authorized 
library. 

□ B. Run INSTSVG 

\ W you have previously installed the GPMS/SYSD SVG for version 6.0 or 
later, you can use the current SVG, Specify the same SVC number in 
&SVGNO in SYSDSETS in SYSDjUSRLIB and do not run the job in 
INSTSVG. 

SYSD.USRLIB(INSTSVG) installs the GPMS/SYSD SVG in the library you specified in the 
SVGLIB parameter in SYSD.USRLIB(STAGBl). This is normally SYSl.LPALIB; 

For OS/390 you will need: to update the lEASVGxx member of SYS1.PARMLIB. Add the 
entry SVGPARM x)oc,REPLACE, TYPE(3)> where xxx is the &SVCNO number you 
specified in SYSDSETS. An IPL with GLPA will be required before the SVG will be 
available for use. 

If you have trouble with the SVG or the installation process, see "Troubleshooting SVG 
Errors" on page 49 and the &SVCNO parameter on page 119. 

□ C. Update the subsystem interface entry 

To use the JES2 SRB queue read method (the &JES2SRB parameter in SYSDSETS is set to 
1i), you must set up a subsystem interface entry for SYSD that matches the &SYSDSSI 
parameter in SYSDSETS. The subsystem entry provides the common anchor to the 
checkpoint information stored in the MVS GSA. 

To further enhance this feature, you can use the extended GSA (ECSA) area in MVS/XA, 
MVS/ESA, or OS/390. To implement the EGSA feature, set the &JES2ARA parameter in 
SYSDSETS to 1. See "Galculating GPMS/SYSD's Memory Requirements" on page 42 for 
more information. 

To add the subsystem interface entry, add a SUBSYS SUBNAMEfSYSDj statement to 
SYSl.PARMLIB(IEFSSNxx), where SYSD is the name specified by the 
SYSD.USRLIB(SYSDSETS) &SYSDSSI parameter. For OS/390, you can add the subsystem 
name dynamically by issuing the SETSSI'ADD>SUBNAME=SYSD operator command 

□ D. I PL the operating system 

If you were able to use a prior version of the SVC and were able to dynamically authorize 
the library and: add the subsystem entry, you will not need to IPL the operating system. 
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/ , Otherwise, IPL the operating system for the library authorization, for the implementation 

of the subsystem interface, and for the SVG to take effect. You must also do an IPL with 
CLPA if the SVC was installed in SYSl.LPALIBi You must do the IPL before you^ test 
CPMS/SYSD. 


Step 4: Preparing for Assemblies 

□ A. Run INSTCOPY 

SYSD.USRLIB(INSTCOPY) executes an IEBGOPY step that copies the source programs 
that are dependent on the version of CICS you are running, giving them new names. Youi 
must run INSTCOPY before youido the assemblies. 

□ B. Run INSTPROC 

To install the PROGs CPMS/SYSD requires, review and run SYSD;USRLIB(INSTPROC). 
Since INSTPROC creates the assembly PROGs, you must run it before you do the 
assemblies.. 



Step 5: Assembling all Programs (if required) 

You must assemble the entire product if youi have GIGS 2.1 or older installed. 

The full assembly is not required for other GIGS levels. H&W provides most of the 
programs preassembled. The preassembled programs have been assembled using GIGS 
3.3 and MVS/ESA 4.3 libraries. The use of these libraries is acceptable, since both GIGS 
and the operating system: calls are upward compatible. You may want to assemble all the 
programs if either your system has a significant amount of IBM maintenance or if you 
want the entire product assembled at your current GIGS, JES and operating system leveK 
If you want to assemble allprograms, continue with this step. If you prefer to use the 
preassembled programs, go directly to "Step 6; Assembling Selected Programs" on page 20. 


The assembly of all the programs requires adequate space in the SYSD.LOADLIB library. 
When SYSDXOADLIB was allocated by SYSD.USRLIB(UNLDSYSD), space was set to 
accommodate one entire reassembly. If you have to restart the assemblies, you should 
compress the library first to avoid SD37 abends caused by lack of space. Do not delete all 
the programs because H&W provides some without source. 


If you set the LIST parameter in STAGEl to YES (NO is the default), you must have 
adequate space in your JES spool to handle the considerable amount of print output. 
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To assemble all programs;: 


□ A. Run [NSTMAPS 

Rfeview and run the job in SYSD;USRLIB(INSTMAPS). This creates the BMS map 
programs and DSECTS. 

□ B. Run INSTPROG 

Review and run the jobs in SYSD.USRLIB(INSTPROG). 

For all the assemblies, a return code of 4 is normal. For CICS 4.1 or newer, a 
return code of 4 is normal for the linkedit steps. Return codes higher than 4 
must be researched. They are generally a problem of specifying libraries for 
GIGS or JES2 that do not match the settings for &GICSREL or &JES2VER:in 
SYSD.USRLIB(SYSDSETS). 


Step 6: Assembling Selected Programs 

If you assembled all programs in Step 5, go directly to "Step 7: Installing the SYSD/ATP 
Option (SYSD Only)" on page 21. 

The following steps perform only the assemblies required due to differences between 
your environment and the environment H&W used to build the distribution library. 



□ A. Run INSTCOMM 

To assemble the programs with dependencies common to all environments^ review and 
run the jobs in SYSD;USRLIB(INSTGOMM). 

□ B. Run INSTCICS 

To assemble the programs with GIGS version dependencies, review and run the jobs in 
SYSD.USRLIB(INSTGIGS). 

□ C. Run INSTJES2 

To assemble the programs with JES2 release dependencies, review and run the jobs in 
SYSD.USRLIB(INSTJES2). 

□ D. Run INSTOS 

To assemble the programs with operating system release dependencies, review and run 
the jobs in SYSD.USRLIB(INSTOS), 
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For air the assemblies, a return code of 4 is normal For CICS 4.1 or newer, a 
return code of 4 is normal for the linkedit steps. Return codes higher than 4 
must be researched. They are generally a problem of specifying libraries for 
GIGS or JES2 that do not match the settings for &GICSREL or &JES2VERin 
SYSD.USRLIB{SYSDSETS), 


step 7: Installing the SYSD/ATP Option (SYSD Only) 



If you have not licensed the SYSD/ATP option, skip this step. 


□ RunINSTATP 

Review and run the job in SYSD.USRLIB{INSTATP). INSTATP performs a link^-edit to 
create the programs for interfacing with CA-Panvalet datasets. 


step 8: Updating CICS Tables 

The CPMS/SYSD STGIASM install process creates several jobs to assist in updating your 
GIGS tables. The jobs are tailored to the GIGS specified by &GIGSREL in 
SYSD.USRLIB(SYSDSETS). 

GIGS Resource Definition Online (RDO) is used wherever possible, but is dependent 
upon the GIGS release and upon the specifications that were made to the CSDGROUP' 
and GSDLIST parameters of SYSD.USRLIB(STAGEl). 

Even if you have GIGS 4.1 or Transaction Server, some tables still require assembly to 
update them. Specifically, the FGT (for the Editor and SYSD/ATP work files because they 
are BDAM), the DCT (for the job submission extrat-partition TDQ), and the Startup and 
Shutdown PUT programs (since they are still'not covered by RDO), 


□ A. Verify the CICS requirements 

Verify the following: 

♦ GIGS version 1.7 or above is installed. 

♦ Auxiliary temporary storage is installed with a GISIZE of 4096 or greater. 

♦ Basic Mapping Support (BMS) is active. This includes PAGEBLD with the terminal 
paging option. SYSD uses the default paging commands specified in the System. 
Initialization Table (SIT).. 
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□ B. Run INSTCTBL 

Review and run the job in SYSD;USRLIB(INSTCTBL). INSTGTBL creates copybooks you 
can use to update the CICS tables* INSTGTBL puts these copybooks in your 
SYSD;USRLIB:or the dataset you specified in the GOPYLIB parameter in 
SYSD.USRLIB(STAGEl). 

INSTGTBL creates the following members: SYSDGX SYSDFGT, SYSDPLT and SYSPLTI. 
Also depending upon your GIGS release, INSTGTBL may create SYSDPGT and SYSDPPT. 

□ C. Update DFHAUPLK or DFHAUPLE 

Add SYSD.USRLIB or the dataset you specified in the GOPYLIB parameter in 
SYSD.USRLIB(STAGEl) into the SYSLIB concatenation of your standard GIGS 
DFHAUPLK or DFHAUPLE assembly procedure. This allows you to use COPY 
statements to copy the SYSD macro entries into you current GIGS tables. 

□ D. Update and Assemble the DCT 

Insert a GOPY statement for SYSDDGT into your DGT assembly source and assemble 
your DGT. This defines the extra-partition DGT required for job submission. 

□ E. Update and Assemble the FCT 

ROview SYSD.USRLIB(SYSDFGT). If FGT entries were generated, insert a GOPY 
statement for SYSDFGT into your FGT assembly source and assemble your FGT. If FGT 
entries were not generated, skip this step and go to "F. Update and Assemble the Startup 
PLT (Optional)." 

This defines the SYSD Editor work file to your GIGS. The SYSD Editor work file is a 
BDAM format file and therefore requires an assembled FGT entry even in the newer 
versions of GIGS. If you have GIGS 3.3 or older installed, SYSDFGT also defines the 
SYSDUSERfile. 

□ F. Update and Assemble the Startup PLT (Optional) 

INSTGTBL generates a default PLT entry (SYSDPLTI) that you can assemble and use at 
startup. 

This PLT invokes SYSD0149 to start hot writers and build internal ATP tables. Its purpose 
is to improve response time by performing lengthy one-time functions at startup rather 
than at first use. 

If you already have a startup PLT: 

1. Manually merge the entry for SYSD0149 from SYSDPLTI into your startup PLT 
assembly source. The SYSD0149 entry must be placed in the second stage of the 
startup process after the DFHDELIM. Second stage only applies to GIGS 3.1 or 
newer. 
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2. Reassemble your PLT. It takes effect during the next cycle of CICS. 


If youi do not already have a startup PLT: 

1. Provide JCL and assemble SYSD.USRLIB(S¥SDPLTI). This creates the DFHPLTxx: 
program, where xx is the suffix specified in SYSDiUSRLIBfSYSDPLTB. 

2. Manually add a PPT entry for DFHPLTxx to a systemigroup using GBDA or by 
adding it to your PPT macro source and reassembling the PPT. 

3. Update the PLTPr=xx parameter in your SIT to specify the suffix. ThePLT takes 
effect during the next cycle of CICS.. 

O G. Update and Assemble the Shutdown PLT (Optional) 

INSTGTBL generates a default PLT entry (SYSDPLT) you can assemble and use at 
shutdown. This PLT invokes SYSD0040 to shut down the OS tasks GPMS/SYSD uses. If 
the tasks are not shut down an SA03 abend occurs. This PLT is not required if your GIGS 
termination.procedures provide for shutting down the GPMS/SYSD OS tasks with the 
SYSD SHUT command. 

For additional information see "Shutting Down GIGS" on page 45. 

If you already have a shutdown PLT: 

1. Manually merge the entry for SYSD0040 from SYSDPLT into your shutdown PLT 
assembly source. The SYSD0040 entry must be placed in the second stage of the 
shutdown process after the DFHDELIM statement. 

2. Reassemble your PLT. It takes effect during the next cycle of GIGS. 

If you do not already have a shutdown PLT: 

1. Provide JGL and assemble SYSD.USRLIB(SYSDPLT). This creates the DFHPLTxx 
program, where xx is the suffix specified in SYSD:USRLIB(SYSDPLT). 

2. Manually add a PPT entry for DFHPLTxx to a system group using CEDA or by 
adding it to your PPT macro source and reassembling the PPT. 

3. Update the PLTSD^xx parameter in your SIT to specify the suffix. The PLT takes 
effect during the next cycle of GIGS. 

□ H. Run INSTUCSD to Update the CSD 

RDO and GIGS 3i1i or. later Only 


w 


Review and run the job in SYSD.USRLIB(INSTUCSD) created by STGIASM. This creates 
the CPMS/SYSD RDO entries to update your aCS System Definition file (CSD). It creates 
program, transaction and file entries and adds them to a SYSD GSD group defined using 
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the group name provided in the SYSD.USRLIB(STAGll) parameter CSDGROUE The 
group is added to the GIGS GSD startup installation list defined by the 
SYSD.USRLIB(STAGEl) parameter GSDLIST. 

If you complete this step, go directly to "Step 9: Greating SYSD Files" on page 24. 


□ I. Run INSTCSD to Migrate SYSD Resources to Your CSD 

RDO and GIGS 1i.7 or 2;l! Only 

Review and run the job in SYSD.USRLIB(INSTGSD) created by STGIASM. INSTCSD 
contains a job that assembles the macro definitions for the GPMS/SYSD PPT and PGT 
entries and then migrates them to your CSD. 

If you complete this step, go directly to "Step 9: Greating SYSD Files" on page 24. 

□ J. Assemble the PPT 

RDO Not Available 

Insert a COPY statement for SYSDPPT into your PPT assembly source and assemble your 
PPT. This defines the CPMS/SYSD programs. 

□ K. Assemble the PCT 

RDO'Not Available 


Insert a COPY statement for SYSDPCT into your PCT assembly source and assemble your 
PCT This defines the CPMS/SYSD transactions. 


step 9: Creating SYSD Files 

□ Run INSTFILE 

Review and run the jobs in SYSD.USRLIB(INSTFILE). 



It is normal for the steps that execute program SYSDWUOl in INSTFILE to 
get D37 abends when you install CPMS/SYSD with the editor and/or the 
SYSD/ATP option. 


INSTFILE creates one or more of the following datasets: 
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This dBtiaseti Is 

SYSDBRSO A BDAM file SYSD/ATP uses as a browse work file. 

(SYSD/ATP only) SYSDBRSO has the same attributes as the editor work; file 
(SYSDWRKO). INSTFILE only creates SYSDBRSO if you 
have the SYSD/ATP optiom 

SYSDUSER A KSDS VSAM file that contains the user profile 

information for the SYSD menu system. The xxxxUSER job ■ 
in INSTFILE creates SYSDUSER. 


SYSDWRKO A BDAM file the SYSD editor uses for work and recovery, 

(SYSD only) The xxxxEWRiC job in INSTFILE creates SYSDWRKO. 


step 10: Updating CICS JCL 

□ A. Update the CICS STEPLIB 

Concatenate a DD statement defining the SYSD,LOADLIB'library to the CICS STEPLIB 
(or JOBLIB) DD statement. 


Note \ You must authorize SYSD.LOADLIB by including it in 

SYSl.PARMLIB(IEAAPFxx) in MVS or in SYSl.PARMLIB(PR€)Gxx) in 
OS/390. OS/390 now allows you to dynamically authorize a library without 
IPL'ing using the SET PROG=xx or SETPROG commands. 


You must authorize all CICS STEPLIB or JOBLIB libraries or you will lose 
authorization on all of them. 


Caution 



If you are running an operating system prior to MVS/ESA, make sure the first library in the 
STEPLIB concatenation has the largest BLKSIZE of all the libraries. To do this, put the largest, 
library first or override the BLKSIZE by coding the DCB5= BII1KSIZE= largest parameter onflte 
first DD statement. 


□ B. Update the CICS DFHRPL 

Concatenate a DD statement defining the SYSD;LOADLIB load library to the CICS 
DFHRPL. CICS loads CPMS/SYSD programs in. the normal manner using the DFHRPL 
DD statements. 
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Gaution 



Make sure the first library in the DFHKPL concatenation has the largest BLKSIZE of all the 
libraries. To do this, put the largest library first or override the BLKSIZE by coding the 
W€.B'=B\lKSl2M=\kr^estparameter on the first DD statement. 


□ C. Add SYSDUSER DD Statement 

Add the following DD statement for the user profile dataset:: 


//SYSDUSER DD DISP=SHR,DSN=SYSD.SYSDUSER 


The INSTFILE job preloaded this KSDS VSAM file. 

□ D. Add SYSDWRKO DD Statement 
SYSDonly 

If you are installing the SYSD editor, add the following DD statement pointing to 
SYSDWRKO, which is the BDAM work file INSTFILE created: 


//SYSDWRKO DD DI SP=SHR,DSNi=SYSD ..SYSDWRKO 


You can change the name or define multiple editor work files after you finish installing 
CPMS/SYSD. See "Using Multiple SYSD Editor Work Files" on page 54 for more 
information. 

□ E. Add SYSDIRDR DD Statement 

If you are installing the SYSD editor or plan to use SYSD/IFT or the job submission 
functions of CPMS, add the following DD statement to define the JES internal reader: 


//SYSDIRDR DD SYSOUT=(A, INTRDR):, 

DCB=(:RECFM-FB,,LRECL=80,BLKSIZE=400); 


□ F. Add SYSDBRSO DD Statement 

SYSD/ATRonly 

If you are installing the SYSD/ATP interface, add the following DD statement pointing to 
SYSDBRSO, which is the BDAM browse work file INSTFILE created: 


//SYSDBRSO DD DISP=SHR,DSN=SYSD.BRWSWRKO 
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You can change the name or define multiple browse work files after youi finish installing 
OMS/SYSD: See "Using Multiple SYSD/ATPBtowse Work Files" on page 56 formore 
information. 

Step 11: Testing the Installation 

□ A. Execute CICS 

Start GICS. Rfeview the startup messages for any obvious errors, like lost authorization or 
missing programs. 

□ B. Perfonm SYSDTEST 

After GIGS comes up normally press Clear on a 3270 device. Type SYSD,SYSDTEST on the 
clear GIGS screen and press Enter. This verifies the SVG, SYSDOSTK, and JES2 interface. 
Messages indicating the status of the GPMS/SYSD installation are displayed. 

If you get a Security Violation - Access Denied message, your systems programmer security 
key is not on. To turn on all security bits, press Clear. Type SYSD,SYSPGMR on the clear 
GIGS screen and press Enters Then retry the SYSDTEST command. See "SYSDTEST - 
Verifying the Installation" on page 68 for more information about the SYSDTEST 
command; 

If the test is successful press Clear. Type SYSD on the clear GIGS screen and press Enter. A 
list of functions and general help information should be displayed. The available 
functions are listed first. To view the next page, press Enter. Several pages into the list, 
there should be some information describing the input format for SYSD. If you cannot 
page through the output by pressing Enter> check your installation procedure forBMS 
Page Build and check the &NPAGGMD and &RPAGCMD parameters in SYSDSETS. See 
the &NPAGGMD parameter on page 113 and the &RPAGGMD'parameter on page 117 for 
more information. 


Step 12: Initializing the Work Files 

I Note \ To perform'EDITINIT and certain other SYSD functions, you must have a 

GIGS signon with a security key of 24 or the security key defined by the 
&DFTINDS parameter in SYSDSETS. You can change &DFTIMDS to the 
appropriate security key. See the &DFTINDS parameter on page 102 and 
Appendix D, INITMAIN Parameters, for more information. You: can use the 
SYSPGMR-command to temporarily bypass security. See the SYSPGMR 
command on page 69 for more information. 
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□ A. Perform EDITINIT for SYSDWRKO (SYSD only) 

If you ran the jobs in INSTFILE to create and initialize the SYSD editor work file, you can 
skip this step. Make sure the SYSDWUOl program executed successfully when you ran 
INSTFILE. 

If you are installing the SYSD editor, you: can use the EDITINIT function to initialize the 
work files. Pfess Clear. Type SYSD>EDITINIir^SYSDWRKOion the clear CICS screen and 
press Enter, The SYSD editor is now ready to use. If an error occurs, see "EDITINIT - 
Initializing the Editor and Browse Work Files" on page 60 for more information about the 
error message. 

□ B. Perform EDITINIT for SYSDBRSO (SYSD/ATP only) 

Ifyou ran the jobs inlNSTFILE to create and initialize the SYSD/ATP browse work file, 
you can skip this step. Make sure the SYSDWUOl program executed successfully when 
you ran INSTFILE. 

If you are installing SYSD/ATP you can use the EDITINIT function to initialize the browse 
work files. Press Clear., Type SYSD/EDITINIT^SYSDBRSOion the clear CICS screen and press 
Enter, SYSD/ATP is now ready to use. If an error occurs, see "EDITINIT - Initializing the 
Editor and Browse Work Files" on page 60 for more information about the error message. 


Step 13: Setting Up the Initial User Profiles 

The menu-driven portion of CPMS/SYSD is user ID and password dependent. 
CPMS/SYSD comes with a user ID and password you must use to sign on.to the menu 
system so you can add a new user ID for yourself. Then you can sign on using your own 
user ID to control the CPMS/SYSD user file. The signon user ID provided is ALL and the 
password is H&W, 

^ To add a user ID for yourself 

1. At the top of a clear CICS screen or at the bottom of a CPMS/SYSD functionrdriven 
screen, type SYSD>MBNU,ALL,H&W,LI and press Enter. TheUser File Maintenance 
screen is displayed, 

2. Type I'(Initialize) in the Input field and press Enter. 

3. Type A (Add) in the fnpwf field. 

4. Tabito the User Identifier field and type your new user_idl 

5.. Tsabito the Possiyord field and type the passwordiyou want to use. 

6. Tabito the Name field and type your name. 

7. Optional. Tab)to the Title field and type your job titife; 
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8. Optional. Jabs to the Deparfment field and type your department 

9. Optional. Jab.to the Address field and type your mailing address. 

10. Press Enter. You can now sign on using your new user ID and maintain the 
GPMS/SYSD user file. See the CPMS/SYSD Reference Manual or the online help for 
more information. 


^ To sign on using your new user ID 

1. At the top of a clear screen or at the bottom of a CPMS/SYSD function^driven 
screen, type SYSD>MENU,userJd>password> where userjd and password iare your 
new user ID and password. 

2. Press Enter. The Primary Option Menu: is displayed. 

^ To select the tutoriali or other functions 

The options listed on the Primary Option Menu have a 1-character option code and an 
alphabetic code associated with them. To access an option, type either option code in the 
Input field and press Enter. 


Step 14: Customizing the Security Exits (New Customers Only) 

Once you have a feel for how CPMS/SYSD works, you are ready to implement security. 
See "Setting Up Security" on page 32 for more information about basic and advanced 
security. Also see "SYSD User Exits" on page 142 for a list of the exits and a brief 
explanation of their use. 
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OperMiomll Comideraiiom 


This chapter discusses some issues you need to consider when operating SYSDi Topics 
include: 

♦ Setting up basic and advanced security. 

♦ Maintaining user profiles. 

♦ Using the MVS Spool Display facility for JES2. 

♦ Using FCBs with spool print. 

♦ Interacting with CICS, including calculating the amount of CPMS/SYSD storage, 
using multiple GICS regions, upgrading CICS after installing CPMS/SYSD, shutting 
down GIGS, supporting large screens, passing control to GPMS/SYSD, and 
supporting MRO. 

♦ Interacting with MVS, including troubleshooting SVG errors and upgrading MVS 
after installing GPMS/SYSD. 

♦ Interacting with JES2, including using the JES2 SRB queue read method, using JES 
datasets, running GPMS/SYSD with a secondary JES2 subsystem, and upgrading 
JES2 after installing GPMS/SYSD. 

♦ Initializing the SYSD editor work file and using multiple SYSD editor work; files. 

♦ Initializing the SYSD/ATP browse work file and using multiple SYSD/ATP browse 
work; files* 


Rfeview this chapter carefully. If you have suggestions, send them to H&W Gomputer 
Systems, Inc, We appreciate your comments. 
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Setting Up Security 

This section discusses GPMS/SYSD's basic security features and the advanced security 
features you can implement after you have installed CPMS/SYSDi 


Basic Security 

CPMS/SYSD bases its basic security on the GIGS security keys—TGTTESK in the TGTTE.' 
GPMS/SYSD matches the GIGS security keys to the security keys specified for the 
parameters in SYSD.USRLIB(INITMAIN). The MENU02 (menu-driven system) and 
FUNGOl (function-driven system) user exits perform the matching. 

As shipped, the GPMS/SYSD menu systemand many other functions are open to all 
users. A few functions can only be performed by users who have a security key equal to 
the key defined by the default security indicator in SYSDSETS. See the &DFTINDS 
parameter on page 102 for more information., 


\ Note Por GIGS version 3.2 and above, FUNGOl and MENU02 are shipped 

U—-»u\ without any default security because the security keys in the TGT were 

eliminated. However, there are examples in the MENU02 and FUNGOl user 
exits for interfacing with RACF, CA-Top Secret, and GA-AGF2. 

Option U, Perform user file maintenance, on the menu system is shipped unsecured. You 
can secure this option by inserting checks in the user exits. GPMS/SYSD passes the value 
of the Admin authority, Control authority, and Receive authority fields to the menu security 
exits. You can define these fields as needed. 


Advanced Security 

You should install GPMS/SYSD with the default basic security. When you are more 
familiar with the product, you can increase security. 

To add extensive security checking, update SYSD.USRLIB(INITMAIN). You: can also add 
more security checking in the user exits in SYSD.USRLIB. Appendix D, IMTMAIN 
Parameters, provides examples of possible security checks. Review SYSD.USRLIB for 
more information. 

Advanced security checks let you:: 

♦ Update INITMAIN to disable functions, secure online help, or bypass security 
checking for a specific function. 

♦ Use the FUNGOl and MENU02 user exits to check the GIGS security keys against the 
security keys in INITMAIN for a function, or setup resources in your security 
package for the SYSD functions. 
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♦ Use the MENU03 user exit to check user profile security—Admm authority, Control 
au thority, and Receive authority fields—^against the menu: functions. 


♦ Use the DSNOOl and DSN002 user exits to secure datasets in browse and edit (SYSD 
only) 

♦ Use the JES201, JES202, JES203, JES206, and JES207 user exits to secure viewing of 
output 


'w 


i ; 
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Maintaining User Profiles 

Option U, Perform user file maintenance, lets you add, change, and delete user profiles. 
For ease in making changes, CPMS/SYSD displays the first user profile in the file when 
you access Option U. Once you make the changes, you mustlog off and log back on to 
CPMS/SYSD for the profile changes to take effect. 

You must have authorization to add, change, and delete user profiles. 


^ To access the User File Maintenance screen 

On the Primary Option Menu, type U in the fnpwf field and press Enter. 



or 


On any CPMS/SYSD screen, type U in the Input (ield and press Returni. 




- K \/ \ ) 

input ===> 


SCROLL: CSR 



USER - BW 

User identifier . ==> DEFAULT1 



Password ==> SYSD 

Name 

==> THIS IS A DEFAULT PROFILE 

Admin authority ==> MASTERI 

Title 

==> USED FOR AUTO PROFILE 

Control authority ==> MASTERS 

Department ==> GENERATION 

Receive authority ==> MASTERS 

Address 

==> ADD1 

JFT only profile ==> N 


==> ADD2 



==> ADD3 



==> ADD4 

Printer view authority ==> Y 

(Y=View 

all, N=View authorized only) 

Authorized (JES2): ==> * 

> 

> > 

printers (CPMS) ==> * 

> 

> > 

Change sel. criteria? ==> Y 

(Y/N> 

Dest.. mask ==> 



Class mask ==> 

Queue display authority ==> Y 

(Y=Display all, N=Display authorized only) 

Q view/ctl auth. (JOB) ==> * 

> 

> > 

(DEST) ==> 

> 

> > 

(DEST) ==> 

> 

> > 

(CLASS) ==> > 

> 

> > > > > 

(MISC); ==> 



A=add I=init D=delete U=update 




Field Definitions 

Field definitions are listed in alphabetical order. 


Address 

The user's mailing address, up to four lines. 
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Admin authority 

An 11-character field that specifies the site-defined security. CPMS/SYSD does not use this 
field internally; it passes this field to the MENUOB user exit 

Authorized printers 

The IDs of the JES2 or CPMS/SYSD printers the user can control. There are up to four 
fields available for each type of printer. You can use a plus sign (+) or asterisk (’^) in the 
printer IDs for generic matching. 

Change seh criteria ? 

A Yes/No field that specifies if the user can change the classes and destinations for a 
printer they are authorized to update. 


Class mask 

The output class the user is allowed to specify when starting a GPMS printer from Option 
7, CPMS Printer Table Display/Ghange. This is a security feature youican use to restrict 
classes to users who have the authority to change selection criteria for hot writers. 



Control authority 

An ll-character field that specifies the site-defined security. GPMS/SYSD does not use this 
field internally; it passes this field to the MENU03 user exit. 


Department 

The user's department. 


Dest mask 

The JES2 destinations the user is allowed to specify when starting a CPMS printer from; 
Option 7, GPMS Printer Table Display/Change. This is a security feature you can use to 
restrict destinations for users with authority to change selection criteria for hot writers. 
You can use a plus sign (+) or asterisk (’*‘) in the destinations for generic matching. 


JFT only profile 

A Yes/No'field that specifies if the user can only access SYSD/JFT panels. If set to N, the 
user can access all CPMS/SYSD's functions, including SYSD/JPT panels. If set to Y, the 
user can only access SYSD/JFT panels. 



Name 


The user's name. 
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Password 

The user's password. 




Printer view authority 

A Yes/No field that specifies if the user can view all the printers. If set to N, the user can 
only view the printers he or she is authorized to control. 


Q view/ctl auth. 

The fields in this section provide a filter that lets you restrict what the user can view and 
control on Option 5, MVS/fES2 Job Queue Display, and Option.6, MVS/fES2 Job Output 
Display. If the fields are left blank, no restrictive filtering is implemented. 


(CLASS) 

The 1-character output class the user can view and control. (Option 6, MVS/JES2 Job 
Output Display only) 

(DEST) 

The lO-character destination the user can view and control. Specify a remote or unit 
queue. 

(JOB) 

The 8-character job name the user can view and control. Specify a prefix, generic, or 
specific job name. 

(MISG) 

A 4-character miscellaneous field GPMS/SYSD passes to the user security exits. 


Queue display authority 

A Yes/No field that specifies if the user can view all the job names in the queue. If set to N, 
the user can,only view authorized jobs. 


Receive authority 

An 11-character field that specifies the site-defined security. CPMS/SYSD does not use this 
field internally; it passes this field to the MENU03 user exit 


The user's job title. 
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Usep identifier 

The ID of the user profile displayed.. 


Command Definitions 

Type the commandiin the fnpwf field:and press Enter. 


Adds a new user profile to the system. 

D=deiete 

Deletes a user profile. If authorized, you can delete any user profile but your own. 

DOWN 

Scrolls down through the user file, displaying the next user profile. 

I-in it 

Displays a clean user profile with the predefined defaults. This lets you^quickly add new 
users. 

U-update 

Updates the user profile. New data typed on the screen replaces the old data in the file. 

UP 

Scrolls up through the user file, displaying the previous user profile. 

Displaying a Specific User Profile 

To display a specific person's user profile; 

1. On any user profile, Tab;to the User Identifier held and type the userjdiyou want 
to review over the current user ID. 

2. Press Erase EOF to delete any extra characters. 

3., Press Enter. 
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Adding a New User Profile 



You can Specify a sample user ID in the MENUOO user exit that has default 
values for the fields. If a person who does not have a user ID signs on, 
GPMS/SYSD automatically creates a user profile for thatperson based on 
the sample user ID. See SYSD.USRLIB(ME]LsnJOO) for more information. 


To add a new user: 

1. Type I! (Initialize) in the Input field and press Enten The screen is initialized with 
the default values. 

2. Type A (Add) in the Input field.. 

3. Tabito the User identifier field and type the new userMd> deleting any remaining 
characters. 

4. Tabito the Passivord field and type the new user's password; 

5. Tabito the Name field and type the new user's name: 

6. Tabito the Title field and type the new user's job title. 

7. Tabito the Department field and type the new user's department 

8. Tabito the Address field and type the new user's mailing address, 

9. Tabito the Printer view authority field. If this user can view all printers, type Y (Yes). 
If this user can only view the printers specified in the Authorized printers field, type 
N(No). 

10. To limit the printers this user can control, Tabito the Authorized printers field and 
type the generic or specific printerJds. 

11. Tabito the Change sel criteria field' If this user can change the selection criteria for 
the printers they are authorized to update, type Y (Yes). If this user cannot change 
the selection criteria, type N (No).. 

If you specify Y (Yes) in the Change sel. criteria field, use the Desf. maslc field 
to limit the override for the CPMS/SYSD hot writer destination to a specific 
or generic destination. 

12. Tabito the Queue display authority field. If this user can only see authorized jobs 
when acressing Option 5, MVS/JES2 Job Queue Display, and Option 6, M¥S/(1ES2 
Job Output Display, type N (No). If this user can see all the jobs in the queue, type 
Y(Yes). 
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13. Tabito the Q view/ctlauth. (Job) field and type the jpb)_name_prefix or the generic 
jpb^names this user can view and control; If you leave this field blank, this user 
has no restrictions. 

14. Tabito the Q view/ctlauth. (Dest) field and type the JES2 destinationJds this user 
can view and control. If you leave this field blank, this user has no restrictions. 

15. Tabito the Qview/ctl auth. (Class) field and type the output classes this user can 
view and control. If you leave this field blank, this user has no restrictions. 

16. Tab to the Q view/ctl auth. (Misc) field and type the data you) want passed to the 
user exits. 

17. Press Enter. 


Updating a User Profile 

If authorized, you can change any field except the User identifier field. An 
error message is displayed if you try to change the User identifier field. You 
should: only change a user profile if the user is not logged on to 
CPMS/SYSD. 

To update a user profile: 

1. Display the user profile you want to change. 

2. Type U (Update) in the Input held. 

3. Tabito the fields you want to change and type the new information; deleting any 
remaining characters. 

4. Press Enter. 



Deleting a User Profile 



If authorized, you can delete any user profile but your own. 


To delete a user profile:; 


1. Display the user profile you want to delete. 

2. Type D (Delete) in the Input field. 

3. Press Enter. 
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Using the MVS Spool Display Facility (JES2) 

To use the Spool Display facility, you mustkeep the normal OS printers from 
automatically printing the jobs. There are two ways to do this: 

♦ You can use the TSO held output class and set up a printer to service that class. Then 
you can view, route, or release jobs for printing. 

♦ H&W recommends you use unit queues, which are similar to remote queues except, 
unitqueues have a name of Unnnniinstead of Rnnnm You can also use alias names to 
define U1 through U9999. You do not need to change JES2 parameters. When you 
route a job's output to a unit queue, the outputstays there until you reroute it to a 
destination serviced by a local or remote printer or until you delete the job. 

To help manage spool space and jobs, you can assign a unit queue to each user. You can 
also define unit queues with aliases. 

To use unitqueues, put a ROUTE card immediately after the JOB card that specifies the 
queue where you want to send the job. For example, specify the ROUTE card for UOOlO 
as:: 


/*R0UTE PRINT UOOtO 


If the job has punch output, you can also include the following ROUTE card 


/*ROUTE PUNCH UOOTO 


When the job is done executing, the outputis in queue UOOlO. You can use Option 5, 
MVS/JES2 Job Queue Display, or Option 6, MVS/JES2 Job Output Display, in the menu 
system to view, route, or delete the output. 
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Using FCBs with Spool Print 

When printing batch jobs in GIGS, GPMS/SYSD uses the standard OS forms control buffer 
(FCB) to determine the form length and positioning. The FCB’defines the length of the 
form and the position of each skip-to-channel command in ii The FCB is an object code 
image that resides in the operating system's SYSl.IMAGELIBi Ydu must define or use an 
FGB in SYS1.IMAG1LIB before printing. 

The &STDFCB parameter in SYSDSETS defines the default FCB to GPMS/SYSD; The 
default FCB as normally FGB26 or FGBZSTDi. The default FCBimage handles most 
printing. It handles paper with,66 lines. You can override the defaultfor a printer by 
specifying the DFTFCB parameter in SYSD.'USRLIB(PTBLMAIN). See the DBTFGB 
parameter on page 125 for more information. See the MVS Systems Programming Library: 
Data Management manusLl (or more information about setting up an FCB; 

You refer to an FCB in your JCL with a 4-character name. JES converts it to an B-character 
name by prefixing it with FCB2; You can construct an FGB name for any output dataset. 
You can use the FCB parameter on the DD statement in your JCL to refer to a specific 
FCB; or you can let it default to the JES default value. The FCB must match the form you: 
are printing on, especially the form's length. If it does not, the printout may creep up or 
down the page as each new page is printed. See your system's JCL manual for more 
information about how to specify the FGB parameter on the DD statement. 

Before CPMS/SYSD prints each SYSOLJT dataset, it builds the appropriate name for the 
FGB and searches SYSl.IMAGELIB to find the corresponding member. If CPMS/SYSD 
does not find the member, the print task issues an error message on the printer and goes 
on to the next output dataset to be printed. If CPMS/SYSD finds the member, it loads the 
FCB into memory and starts printing. 


Caution 



Eve?! if your normal system printer does not require FCB images, CPMS/SYSD does. 
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Interacting with GICS 

This section discusses some issues you need to consider about how CPMS/SYSD and 
CIGS interact. 


Calculating CPMS/SYSD's Memory Requirements 

The amount of memory CPMS/SYSD requires is proportional to JES2's JOBNUM and 
JOENUM initialization parameters. JOBNUM and JOENUM are the standard JES2 
initialization parameters specified in SYSl.PARMEIB(JES2PAm). JOBNUM defines the 
maximum number of jobs JES2 lets exist in its queues. JOENUM defines the maximum 
number of job output elements JES2 lets exist in the output queue. 

To calculate the approximate amount of memory GPMS/SYSD requires, multiply the 
values of JOBNUM and JOENUM by their respective sizes, rounding each up to a 4k 
boundary. Then add 14k for GPMS/SYSD buffers and work areas. To determine the size of 
each, use the following table or look at the JQELNGTH or JQEBLEN label and the 
JOESIZE label in the SYSD0104 assembly or in your JES2 assemblies. 


J^S2 version! 

JOBNUM (JQELNGTH) 
or (JQEBLEN) 

JOENUM 

(JOESIZE) 

SP 1.3,6,2.1,5,2.1.7 

28 

88 

SP 2.2.0 

52 

88 

SP 3.1.1 

60 

88 

SP4,1.0 

96 

100 

SP 4.2.0,4.3.0 

88 

100 

SP'5.1.0 

96 

104 

SP5.2,0 

100 

104 


For example, assume you have JES2 version SP 4.2.0 with JOBNUM-500 and 
JOENUM=1000. The approximate CPMS/SYSD memory required is calculated as: 

JOBNUM X 88 = 44000 rounded up to 4k = 44k 
JOENUM X 100 = rOOOOO rounded up to 4k = 100k 

+ 14k = 14k 

Total. 158k 
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r- €PMS/SYSD gets the amount of memory required from either CICS ©SCORE, MVS CSA, 

MVS Extended CSA (ECSA). Use one of the following methods to get the checkpoint 
information: 

♦ SRB queue read method -The &JES2SRB parameter in SYSDSETS is set to T 


GPMS/SYSD'gets the memory requirements from either CSA or ECSA and uses an 
SRB method to copy the informatiomfrom the JES2 address space. There is no I/O' 
involved. If you have CPMS/SYSD installed in multiple GICS regions, the CSA area 
is shared. IB they are defined to use the SRB;method, all the GICS regions 
CPMS/SYSD is installed in use the same CSA area. 

To implement the ECSA feature, set the &JES2ARA parameter in SYSDSETS to li 

♦ Checkpoint read method - The &IES2SRB parameter in SYSDSETS is set to 0; 

CPMS/SYSD gets half of the memory requirements calculated using the formula on 
page 42 from©SCORE and then dynamically expands up to the maximum needed 
to handle the number of JQEs and JOEs used. If there is not enough ©SCORE 
available, this method bypasses the amount needed for the JOEs and disables 
Option 6, MVS/JES2 Job Output Display. Each time a user accesses Option 6, 
CPMS/SYSD issues an error message. If there is not enough OSCORE for the JQEs, 
CPMS/SYSD issues a 608x abend. 


I 

1 

Using Multiple CICS Regions 

Most of SYSD's programs can be shared between multiple CICS regions. You can 
concatenate SYSD.LOADLIB into each CICS region's DFHRPL. You may need to putthe 
following programs in a library concatenated ahead of SYSD.LOADLIB since they may 
contain code or tables unique to your CICS regions: 




This program! Contains 


SYSD0074 The user exit code. This program can be shared unless each CICS 

region needs different exits, 

SYSDBRWS The DDNAMEs of the SYSD/ATP browse work file. Normally, 
this programican be shared unless you use multiple or different 
browse work file names. (SYSD/ATP only) 


SYSDINIT The SYSD initialization parameters. This program can be shared 

unless you had to change SYSDSETS or INITMAIN for the 
individual GICS regions. 


(continued) 
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This pmgmmt Contains 

SYSDPTBL Printer table definitions. You may be able to have a universal set 

of definitions that cover the requirements for all the CICS 
regions. 


SYSDWORiC The DDNAMEs of the editor work file. Normally, this program 
can be shared unless you use multiple or differenteditor work 
file names, (SYSD only) 



You must define separate SYSDUSER, editor work files, and SYSD/ATP browse work files 
for each GIGS region and point to them in the GIGS startup JGL. Use the SYSD EDITINIT 
function to initialize the new editor work files and SYSD/ATP browse work files * You can 
use the Batch Work File utility to perform the EDITINIT function. See "EDITINIT (El) 
Function" on page 75 for instructions. Then bring up the new GIGS region and add user 
IDs to the SYSDUSER file using Option U in the menu system. 


Upgrading CICS after Installing CPMS/SYSD 

Before you upgrade GIGS, call H&W Customer Support or visit our World 
Wide Web site (http://www.hwGS.com) for the latest installation information. 



To support a new version of GIGS after you have installed CPMS/SYSD: 

1. Change the value of the «§:CICSREL parameter in SYSDSETS to reflect the new 
CICS version. 

2, Update the following parameters in STAGE!: 


♦ &GIGSCLA 

♦ &GIGSCSD 

♦ &CICSMAG 

♦ &CICSOBJ 

♦ &GICSSRC 

♦ &GSDFCTG 

♦ (&CSDLIST 

♦ &GSDPCTG 


♦ &GSDPPTG 


3. Rferun the STGIASM job. 

4. To reinstall the assembly PROCS/ run the INSTPRG)C job. 
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In the next step, you must run INSTGQPY before you run INSTCOMM and 
INSTCICS. 


5. Run the INSTCOPY, INSTGOMM, and INSTCICS jobs. 

6. For GIGS version 2.1 and below, run the INSTGSD job. For GIGS version 3.1 and 
above, run the INSTUGSD job. 

7. If you aie not using RDO, reassemble your PPT to account for any new or deleted 
programs. 

8. Cycle GIGS. 

9. Issue the SYSD,SYSDTEST command. 


shutting Down CICS 

CPMS/SYSD uses auxiliary OS subtasks to perform OS requests. The OS subtasks start 
when you: first invoke SYSD. SYSD provides a PLT program called SYSD0040 that 
automatically terminates the OS subtasks when you shut down GIGS. To shut down GIGS 
and activate the PLT program, type one of the following commands and press Enter: 


CSMT SKUTD0WN„N0 
CEMT P SHUT 


The NO option of the GSMT SHUTDOWN command invokes the PLT, but all the OS 
subtasks terminate before GIGS terminates. See the CICS System Programmer's Manual, for 
more information. 

You can also use the SHUT function to shut down SYSD separately from GIGS. The SHUT 
function terminates the OS subtasks and disables SYSD. Then issue the CSMT 
SHUTDOWN command with the YES option or issue the GEMT P SHUT command with 
the IMMEDIATE option. If you do not use either option, GIGS terminates with an SA03 
abend. 

You can also use the following SYSD SHUT functions to terminate SYSD and CICS: 


SYSD,SHUT 


This command only terminates SYSD. 


Installation Manual 


45 






Chapter 3 — Operational Considerations 


SYSD,SHUT„NO 


This command terminates SYSD and GIGS just as if you: had issued the GSMT 
SHUTDOWN,NO or GEMT P SHUT command. 


SYSD,SHUT,YES 


This command terminates SYSD and GIGS just as if you had issued the GSMT 
SHUTDOWN,YES or GEMT P SHUT IMMEDIATE command. 


Supporting Large Screens 

SYSD uses the large screens for 3270 devices whenever possible. If you: have large screens, 
make sure the TGT entry for the device reflects the alternate screen values. If the terminal 
does not actually have large screen capability, make sure the TGT entry does not contain 
alternate screen values. SYSD does not require any changes to use large screens. 

You do need to add the SGRNSZE=ALTERNATE parameter to the 
SYSD PGT entry. 



Passing Control to CPMS/SYSD (Application Program Interface) 

Your user programs can invoke GPMS/SYSD. Optionally, GPMS/SYSD will transfer 
control (XGTL command) back to the program you specify when returning from the 
menu system. 

To invoke GPMS/SYSD from a command-level program, put the GPMS/SYSD command 
in the GOMMAREA and transfer control to the SYSD0136 program. You can use any 
programming language. To return control from the menu system to a user program, put 
the user program name in parentheses after the RETURN keyword as the first parameter 
in the GOMMAREA. 

To invoke a non-menu GPMS/SYSD function or if you do not require a return program, 
omit the RETURN parameter and begin the GOMMAREA with the SYSD command or 
the value you specified for the &MTRNID parameter in SYSDSETS. 


If you: omit the RETURN parameter or invoke a SYSD command other than MENU, 
control returns directly to GIGS. 

The program that transfers control to SYSD0136 must have a TWA size large enough for 
GPMS/SYSD. See the TWASIZE= parameter in our PGT copybook in 
SYSD.USRLIB(INSTGTBL). 



i i 

'K_/ 
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DC 'RETURN<PROGABC),SYSD MENU USERA PSWA 5' 


This command is passed in the COMMAREA to SYSD0136 where it invokes the 
CPMS/SYSD menu'system, signs on USERA with the password PSWA, and displays 
Option 5, M¥S/J1S2 Job Queue Display. Once the user has signed on, the full'menu 
system is available. When the user returns from the menu system, PROGABO receives 
control through the XCTL command and the constant FROM SYSD is passed to 

it in the GOMMAREA. PROGABG must be a command-level program with an entry in 
the GIGS PPT. If processing depends on recognizing the return condition, PROGABC can* 
check for the RETURN FROM SYSD constant. 

SYSD.SOURCE(SYSDXGTL) contains a sample Assembler language programi See 
SYSDXCTL for more information. 



Supporting MRO 

GPMS/SYSD supports MRO under the following guidelines: 

♦ Transactions that display GIGS tables and memory are limited to the region the 
GPMS/SYSD programs reside in (application-owning region). 

♦ When you specify separate regions for terminals and GPMS/SYSD applications, you 
can use the GIGS GRTE facility to establish the link from the terminal to the 
GPMS/SYSD region. To have the SYSD and SYSI transactions automatically establish 
the necessary link, put remote entries in the terminal-owning region's PGT. 


♦ To print to a terminal that does not reside in the application-owning region, put an 
entry in PTBLMAIN that specifies the remote printer's TRMIDNT as listed in the 
application-owning region's TGT. Reassemble the SYSDPTBL program. 

♦ When issuing the PJ and PQ GPMS/SYSD commands, specify the printer ID as the 
TGT TRMIDNT, not the RMTNAME if the two are different. This must also be the 
printer ID specified in PTBLMAIN. 


♦ To issue the P=print option on Option 5, MVS/JES2 Job Queue Display, set the 
printer ID on Option 0.1, JES/List Parameter Definitions, to the target printer's 
TRMIDNT. 


♦ For GPMS/SYSD to translate uppercase and lowercase characters properly in an 
MRO environment of GIGS 3.3 or older,, you must define the following transaction 
and program in all the terminal-owning regions that access GPMS/SYSD; 
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DFHPCT TYPE=ENTRY,, 
PROGRAM=SYSD0138„ 
TWASIZE=0, 
TRANSEC=01, 
TPURGE=YES, 
SPRUGE=YES, 
TRAMSID=SYST 

DFHPPT TYPE=EMTRY,, 

PGMLA«G=ASSEMBLER, 

PROGRAM=SYSD0138 


You can change the TRANSID parameter, but it must correspond to the &MROTNID 
parameter specified in SYSDSETS. See the &MROTNID parameter on page 112 for more 
information. 


In GICS version 4 and above, you do not need to define the transaction and 
program in the terminal-owning region. 
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Interacting with MVS 


This section;discusses some issues you need to consider about how CPMS/S¥SD and MVS 
interact. 


Troubleshooting SVC Errors 

If you do not install the SYSD SV€ correctly, GIGS abends when you; execute SYSD; If this 
happens, make sure: 

♦ The SYSDTEST function was performed without errors during the installation. 

♦ The SVG module name generated by SYSD.USRLIB(INSTSVG) reflects the assigned 
SVG number. The last number should be a character, not a number. 

♦ The SVG number is defined as a type 3 or type 4 SVC in your OS SYSGEN. Avoid 
type 1 or type 2 SVGs and SVG numbers that end in zero. 

♦ The chosen SVG does not have any SVC locks enabled. 

♦ The SVC was installed in SYSl.LPALIB and you have performed an IPL with a GLPA. 

Only the CPMS/SYSD function should use the SVG. If an unauthorized batch or GIGS 
program tries to use this SVC, the following happens: 

♦ The following error message is displayed on the security and master consoles: 

E999 UNAUTHORIZED USE OF THE H&W SVC-CONTACT SECURITY ADMINISTRATOR 

♦ GPMS/SYSD overlays a hexadecimal 00 and the E999 error message in the program's 
memory at the return address, 

♦ An OCl abend occurs. 

You; can then match the message on the security console and identify the program; that 
tried to use the SVG. 
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Upgrading MVS after Installing CPMS/SYSD 



Before you upgrade to MVS/XA, MVS/ESA, or OS/390, call H&W Customer 
Support or visit our World Wide Web site (http;//www,.hwcs.com) for the 
latest installation information. 


To support a new version of MVS after you have installed CPMS/SYSD: 

1. Change the value of the (SeOSLEVEL parameter in SYSDSETS to reflect the new 
operating system. 

2. Rerun the STGIASM job. 

3. To reinstall the assembly PROCs, run the INSTPROC job., 

4. Run the INSTCOMM and INSTOS jobs. 

5. Cycle CICS. 

6. Issue the SYSD,SYSDTEST command. 
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Interacting with JES2 

This section discusses some issues you need to consider about how GPMS/SYSD and; jlS2 
interact. 


Using the JES2 SRB Queue Read Method 

To use the JES2 SRB queue read method: (the &JES2SRB parameter in SYSDSETS is set to ' 
1), you must set up a subsystem interface for SYSD that matches the &SYSDSSI 
parameter in SYSDSETS. If you have set the &JES2SRB parameter in SYSDSETS to 1i, the 
&SYSDSSr parameter provides the common anchor to the checkpoint information stored 
inMVSCSAorECSA. 


To add the subsystem interface entry, update SYSl.PARMLIB(IEFSSNxx) with the name 
specified for the &-SYSDSSI parameter. IPL MVS to make the change take effect. See the 
OS/MVS Systems Programming Library: Job Management manualior more information. 

Beginning with OS/390 1.1, the subsystem entry can be dynamically added with; the OS 
command SETSSI ADD;SIJBNAME=SYSD, Existing entries can be displayed with the OS 
command D SSI,SUBSYS=SYSD. 


Using JES Datasets 

If you: are using a JES function, like the spool display, all the JES-related datasets must 
begin on a cylinder boundary. For JESS, the JCT dataset must be a maximum of one 
cylinder. If you: do not meet these requirements, CICS abends with an S500 completion 
code. Other complications may also occur. 


Running CPMS/SYSD with a Secondary JES2 Subsystem 

You can set up CPMS/SYSD to use a JES2 that is being run as a secondary subsystemi To 
use the checkpoint queue read method, set the &JES2JBI parameter in SYSDSETS to the 
secondary subsystem name and set the &JES2SRB parameter in,SYSDSETS to Oi 
Reassemble SYSDINIT and cycle GIGS. If the secondary subsystem is not running before 
you use CPMS/SYSD, a 61 IB abend occurs. 

The normal limitations of running a secondary subsystem apply. , When you submit jobs, 
they only go to the primary subsystem because of the internal reader restrictions. The 
primary subsystem handles SYSLOG, which is not available for viewing by CPMS/SYSD^ 
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Upgrading JES2 after Installing CPMS/SYSD 



Before you; upgrade JES2, call H&W Gustomer Support or visit our World: 
Wide Web site (http://www.hwGS.Gom) for the latest installation information. 


To support a new version of JES2 after you have installed CPMS/S¥SD‘ 

1. Change the value of the &JES2VER parameter in SYSDSETS to reflect the new JES2 
version. 

2. Change the value of the &JES2SRG parameter in STAGEl to reflect the new IES2 
library. 

3. Rerun the STGlASM job. 

4. To reinstall the assembly PROGs, run the INSTPRQC job. 

5. Run the INSTGOMM and INSTJES2 jobs. 

6. Cycle GIGS. 

7. Issue the SYSD/SYSDTEST command. 
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Using the SYSD Editor 

This section discusses some issues you need to consider when you allocate and maintain 
the SYSD editor. 


Initializing the SYSD Editor Work File (SYSD Only) 

The SYSD editor work file is a BDAM file that is random, contains its own directory, and 
need not be reorganized. You must run SYSD;USROB(INSTFItE) to preformat the file. 
You can also use the EDITINIT function to initialize the file. Since SYSD uses CICS 
facilities to read and write to the editor work file, the file's physical block size must agree 
with the FCT entry. See "EDITINIT (El) Function" on page 75 for more information about 
initializing the editor work file. 

The &EDTBLKS parameter in SYSDSETS defines the editor work file's block. The block 
size can be any size between 1024 and the track size. H&W recommends you use a block; 
size of around 4096, depending on the device type. Rbund up or down for best 
optimization of disk space. The block size limits the number of records that can be edited., 
For an 80 byte LREGL, a block size of 4096 allows edit sessions of up to 16,895 records.,To 
perform the actual calculation for the maximum records per editsession^ use the 
following formula: 


maximum 
records per 
edit session 


(WORKDATASET BLKSIZE - 256) 

. V 

(WORKDATASET BLKSIZE - 20) 

- 1 


10 

(LRECL + 12) 




Drop any remainders! 


The editor work file's main function is to act as a work and recovery file while you are 
editing. However, you: may want to maintain small JCL datasets as active sessions for 
quick access. Space requirements vary based on the type of user and your company's 
policies. Development users require up to 300 4k blocks of space, while other types of 
users require less. H&W recommends you start with the space specified in 
SYSD:USREIB(INSTFILE). You can then use the EDITLIST function to monitor how much 
space is used; 

To calculate the maximum number of blocks the editor work file can contain, use the 
following formula: 


maximum 

blocks = (WORKDATASET BLKSIZE - 256) x 8 

addressable 
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Allocating more blocks than this results in wasted space. After you determine the number 
of blocks you need for your types of users^ you can reallocate and reinitialize the editor 
work file. Remember to save all active sessions before reinitializing the editor work file or 
you will lose them. 


U^ing Multiple SYSD Editor Work Files 

SySD.USRLIB(WORKMAIN) defines the DDNAMEs for each required editor work file. 
H&W recommends you define DDNAMEs of SYSDWRKO through SYSDV/RKh. After 
you update WORKMAIN, assemble SYSDWORK. 


Each editor work file requires a separate FCT entry. To create the FGT entries^ duplicate 
the entry for SYSDWRKO and reassemble the FCT. The EDTEXTOl user exit in 
SYSD.USRLIB selects the editor work file you will use. See the source for EDTEXTOl for 
more information. 



Since Resource Definition Online (RDO) does not support BDAM files, you 
must use the DFHFCT macro to define the editor work files' FGT entries. 
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Using the SYSD/ATP Browse Work File 

This section discusses some issues you need to consider when you allocate and maintain 
the SYSD/ATP browse work file. 


Initializing the SYSD/ATP Browse Work File (SYSD/ATP Only) 

The SYSD/ATP browse work file is a BDAM file that is random, contains its own directory, 
and need not be reorganized. You must run SYSD.USRLIB(INSTFILE) to preformat the 
file. You can also use the EDITINIT function to initialize the file. Since SYSD uses CI€S 
facilities to read and write the browse work file, the file's physical block size must agree 
with the FGT entry. See "EDITINIT (El) Function" on page 75 for more information about 
initializing the browse work file. 

The &EDTBLKS parameter in SYSDSETS defines the browse work file's block size. The 
block size can be any size betweenl024 and the track size. H&W recommends you use a 
block size of around 4096, depending on the device type. Rbund up or down for best 
optimization of disk space. The block size limits the number of records that can be 
browsed. For an 80 byte LREGL, a block size of 4096 allows browse sessions up to 16,895 
records. To perform the actual calculation for the maximum records per browse session, 
use the following formula: 


maximum 

records per = 

browse session 

(WORKDATASET BLKSIZE - 256) 

(WORKDATASET BLKSIZE - 20) 

-1 

. A 

10 

(LRECL+12} 



Drop any remainders 

1 


The SYSD/ATP browse work file's main function is to act as a work file while you are 
browsing GA-Panvalet datasets. Space requirements vary based on the number and type 
of simultaneous, active browse sessions. H&W recommends you start with the space 
specified in SYSD.USRLIB(INSTFILE). You can then use the EDITLIST function to 
monitor how much space is used. 

To calculate the maximum number of blocks for the SYSD/ATP browse work file, use the 
following formula: 


maximum 

blocks = (WORKDATASET BLKSIZE - 256) x 8 

addressable 



Allocating more blocks than this results in wasted space. After you'have determined the 
number of blocks you need for your types of users, you can reallocate and reinitialize the 
browse work file. 
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Using Multiple SYSD/ATP Browse Work Files 


SYSD.tJSROB{BRWSMAIN) defines the DDNAMEs for each required browse work file. 
H&W recommends you define DDNAMEs of SYSDBRSO through SYSDBRSn. After youi 
update BRWSMAIN, assemble SYSDBRWS. 


Each browse work file requires a separate FGT entry. To create the FGT entries, duplicate 
the entry for SYSDBRSO and reassemble the FGT, The BRSEXTOl user exit in 
SYSD.USROB selects the browse work file you will use. See the source for BRSEXTOl for 
more information. 


Since Resource Definition Online (RDO) does not support BDAM files, you 
must use the DFHFGT macro to define the browse work files' FGT entries. 
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This chapter describes the menuisystem option and commands the GPMS/SYSD 
administrator can use to control the system. Since the average user does not need to use 
these commands, they are described here instead oiin the CPMS/SYSD Reference Manual 
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Option 

Buffers 


L - Displaying the Master Console's Active 



Option L is a special option that is not displayed on the Primary Option Menu, but is 
available to the GPMS/SYSD administrator. Option L, MVS Console Display, lists the 
master console's active buffers thathave not been written;to the spool The following is 
an example of the information displayed:: 


O-’P? • 

pQ__ 











nVo LUN^ULt 

UibrLAT '* 




- C i/U, 

INPUT = 

==» 








SCROLL: CSR 

$HASP375 

MSAROWLS 

ESTIMATE 

EXCEEDED 

BY 

1,300,000 

LINES 

13 

% 

SPOOL 

$HASP375 

MSAROWLS 

ESTIMATE 

EXCEEDED 

BY 

1,310,000 

LINES 

13 

% 

SPOOL 

$HASP375 

MSAROWLS 

ESTIMATE 

EXCEEDED 

BY 

1,320,000 

LINES 

13 

% 

SPOOL 

IST530I 

CINIT PENDING FROM 

MVS390 TO CICS32 FOR E607 527 




I ST 10511 

EVENT CODE = 0201 








I ST 10621 

EVENT ID 

= 0000000100010000000100160201088106010004 



IST314I 

END 









I ST5301 

CINIT PENDING FROM 

MVS390 TO CICS32 FOR TCP00023 528 



IST1051I 

EVENT CODE = 0201 








I ST 10621 

EVENT ID 

= 0000000100010000000100160201088106010006 



IST314I 

END 









$HASP375 

MSAROWLS 

ESTIMATE 

EXCEEDED 

BY 

1,330,000 

LINES 

13 

% 

SPOOL 

$HASP375 

MSAROWLS 

ESTIMATE 

EXCEEDED 

BY 

1,340,000 

LINES 

13 % 

SPOOL 

$HASP375 

MSAROWLS 

ESTIMATE 

EXCEEDED 

BY 

1,350,000 

LINES 

13 % 

SPOOL 

$KASP375 

MSAROWLS 

ESTIMATE 

EXCEEDED 

BY 

1,360,000 

LINES 

13 

% 

SPOOL 

$HASP375 

MSAROWLS 

ESTIMATE 

EXCEEDED 

BY 

1,370,000 

LINES 

13' % 

SPOOL 

$HASP375 

MSAROWLS 

ESTIMATE 

EXCEEDED 

BY 

1,380,000 

LINES 

13 % 

SPOOL 

$HASP375 

MSAROWLS 

ESTIMATE 

EXCEEDED 

BY 

1,390,000 

LINES 

14 

% 

SPOOL 

$HASP375 

MSAROWLS 

ESTIMATE 

EXCEEDED 

BY 

1,400,000 

LINES 

14 

% 

SPOOL 

$HASP375 MSAROWLS 

ESTIMATE 

EXCEEDED 

BY 

1,410,000 

LINES 

14 

% SPOOL 



Occasionally, the screen will not display a full page. This means the buffers did not 
contain enough data for a full screen because they have been written to the spool. You 
can use Option 5, MVS/JES2 Job Queue Display, to display this data by setting the prefix 
to SYSLOG and selecting the executing SYSLOG. If there are any outstanding WTORs, 
they are displayed at the bottom of the Option L screen. 

The SYSLOl security exit lets you secure the commands that can be issued from Option E. 
See the online help for a list of the valid commands. 
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Functional Commands 

This section describes the commands the administrator can use to control the system. 


ATPTBL - Building an ATP Dataset Member Table 

The ATP dataset member table contains a list of GA-Panvalet datasets and pointers that 
tell CPMS/SYSD where the members are imthe directory. The ATPTBE command either ' 
creates a new ATP dataset member table or adds a new dataset's members to the existing 
table.' 

The browse and edit ATP directory functions use this table internally to speed up 
processing. You should issue this command for every CA-Panvalet dataset that has a large 
number of members. If you issue this command a second time for a dataset, CPMS/SYSD 
refreshes the member table. 

The format of the ATPTBL command is: 


SYSD,ATPTBL [,yol._ser] .dataset 


This parameter Specifies 

voli_ser The volume serial number where the ATP dataset resides. The 

default is the OS cataloged entry. 

dataseti The 1- to 44-character name of the ATP dataset you want to 

add to the table. 


DPROG - Displaying Program Statistics 

The DPROG command: displays a summary of statistics for a CPMS/SYSD program. You: 
can also use the DPROG command to display the statistics for a CPMS/SYSD function 
and see which CPMS/SYSD programiit is executing. The formatof the DPROG command 
is:: 


SYSD,DPROG[,program_idIFUNC=function_id3 
DP 
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This pammeter Specifies 

programjdi The program you want to display statistics for. The default is a 

summary of statistics for all the programs, 

functfonj_idi The CPMS/SYSD'function you want to display statistics for. 


EDITINIT - Initializing the Editor and Browse Work Files 

The EDITINIT command initializes the SYSD'editor or SYSD/ATP browse work file. You 
must issue the EDITINIT command before using the SYSD editor. The format of the 
EDITINIT command is: 


SYSD,ED I T I N I T, f i le_name [,FORCE(FAST] 
El 


Caution 



The FORCE parameter destroys any existing edit sessions. Do not use the FAST parameter 
during the first initialization. 


This parameter Specifies 

filfe_name The name of the editor or browse work file you want to 

initialize. This is the same name as specified for the FILE= 
parameter in WORKMAIN or BRWSMAIN. 

FORCE Initialize the active work file. 

FAST Perform a quick re-initialization of the work file. 


Prompts and error messages 

The following are possible prompts and error messages:: 


Successful completion prompt 


*** INITIALIZATION SUCCESSFUL *** 


The editor or browse work file has been properly initialized. 
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General error messages 


*** Dataset name is invalid or missing., *** 


The fiife_name parameter was not specified on the EDITINIT command. 


*** DATASET NAME IS NOT IN SYSDWORK:*** 


The file_name parameter must match a DD= parameter in WORKMAIN. Correct the 
command or correct WORKMAIN and reassemble SYSDWORK using the JCL in 
SYSD.USRLIB(INSTCOMM). 


***EDT001E - DATASET ACTIVE,, SPECIFY FORCE*** 

You must use the FORCE parameter to initialize an active work file. 

Validate FCT against SYSDWORK 

***FCT ENTRY NEEDS ADD OPTION*** 

The FCT entry does not have the add, update, unblocked, or fixed attributes. Copy the 
FCT entry generated by INSTCTBL to your FCT again and reassemble it. To check the 
FCT entry, issue the GEMT INQ FIliE{fct_id) command. 


***DATASET NAME IS NOT IN FCT*** 


The FCT entry in CIGS is missing. Check the FCT, update it, and reassemble it if necessary. 


Initialize file 


***MASTER RECORD WRITE ERROR*** 
***MASTER BIT HAP READ ERROR*** 

***1ST DIRECTORY BLOCK READ ERROR*** 
***1ST DIRECTORY BLOCK WRITE ERROR*** 


These error messages indicate read and write errors on the editor work file; Make sure the 
file is not being shared by multiple GIGS regions and the block size specified in the FCT 
matches the block size specified on the work file. See "Using the SYSD Editor" on page 53 
and Appendix F, Editor and Browse Work Files, for more information. 
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EDITLIST - Displaying Edit Sessions in a Work File 

The EDITLIST command displays a list of the edit sessions in a work file and their 
directory information. Youican use this command to monitor space allocation and usage, 
The format of the EDITLIST command is; 



This pammeter Specifies 

fllfe_name The 1-to 8-character name of the work file you: want to 

display. The default is the first work file specified in 
SYSD.USRLIB(WORKMAIN). 

userjdi The user ID of the person whose editsessions you want to 

display. The default is all the edit sessions. 

The work file must exist in the FGX be defined in WORKMAIN, and be open and 
enabled. You must have previously formatted the work file with EDITINIT. 

The following is an example of the information displayed: 


11/03/97 MVS/ESA VERSION OF CPMS/SYSD RELEASE 6,4.1 PAGE 042 

MONDAY EDITOR SESSION LIST FOR SYSDWRKO 14:21:17 

MEMBER.DATASET.-. USERID-- 

BLKS<00011) RCDS(00416) LRECL(00080) FIRST(01109) 

XREF BA.JCL.SOURCE BA 

BLKS(OOOOI) RCDS(OOOII) LRECL(00080) F1RST(04821) 

XREF DD.JCL.SOURCE DD 

BLKS(t)OOOI) RCDS(OOOn) LRECL(00080) FIRST(02684) 

XXXX JL.JCL.SOURCE JL 

BLKS(OOOOI) RCDS(OOOOO): LRECL{00080) FIRST{02470); 

ZEROT EH.JCL.SOURCE EH 

BLKS<00002); RCDSCOOOIS) LRECL(00080) FIRST(04862) 

999FIX MF.JCL.SOURCE MF 

BLKS(00002): RCDS(00062) LRECL(00080) FIRST(02269): 


************ WORK FILE STATUS ************ 

CURRENT NUMBER OF DIRECTORY ENTRIES = 00376 
BLOCKS ALLOCATED = 08000 BLOCK SIZE = 04096 

BLOCKS IN USE = 05837 PERCENT IN USE = 73 

BLOCKS FREE = 02163 

P/N 
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Field Definitions 

BLKS 

The number of blocks allocated to the work file. 


Dataset 

The dataset the member is saved in. 


First 

The first block number. 


LRECL 

The logical record length. 


Member 

The member name. 


W rcds 

The number of records in the work file. 


USERID 

The edit session owner's user ID; 


JES2FREE - Freeing the JES2 Internal Areas 

The JES2FREE command frees the JES2 internal areas GPMS/SYSD uses. If a problem, 
occurs with these areas, the easiest way to recover is to free them; Any tasks that are 
currently using these areas abend, but the next JES2 request copies fresh areas and lets 
GPMS/SYSD continue. You should only issue this command when absolutely necessary. 
The format of the JES2FREE command is: 


SYSD,JES2FREE 


'W 
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JES2LJOB - Displaying a Job's JES2 Control Blocks 

The JES2LJOB command displays the JES2 control blocks in the J1S2 job queue and spool. 
You can use this command for debugging purposes, but you should only issue it at the 
request of H&W Customer Support. The format of the JES2LJ0B;Gommand is: 


SYSD,,J ES2L JOB, j ob_ 1 d 


This parameter Specifies 

jpb)_ldi The name or number of the batch job you want to display. 

PRTQUEST - starting a Spool Writer 

The PRTQUEST command starts one or more GPMS/SYSD hot writers. This command 
uses the default selection and disposition parameters specified in the printer's table entry. 
The format of the PRTQUEST command is: 


SYSD,PRTQUEST,printer_mask 
PQST 


This parameter Specifies 

printieri mask The ID of the printer terminal you want to start a hot writer 

for. You can specify a single CICS printer terminal ID or a 
generic mask if you want to start more than one hot writer. 
You can use a plus sign (+) or asterisk (*) as wildcard 
characters in the printer terminal ID: 

If you specify an actual printer ID, GPMS/SYSD starts the hot 
writer using the default selection and disposition options, 
regardless of the AUTOSTR specification. If you specify a 
printer mask, GPMS/SYSD only starts the printer entries that 
have AUTOSTR=YES specified in PTBLMAIN., 



If the hot writer selection and disposition options fail, GPMS/SYSD displays 
error messages and sets them in the printer's table entry. You can use the 
PRTDSP command to view these messages. See the CPMS/SYSD Reference 
Manual for more information about the PRTDSP command. 
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START - Starting CPMS/SYSD 

The START command issues a message to the master console or the requesting terminal 
indicating GPMS/SYSD has been started. The format of the START command is: 


SYSD,START 


STPSCN - Stopping the Global JOE Writer Scanning Task 

The STPSCN command stops the CPMS/SYSD global JOE writer scanning task. You can 
use this command to keep any new JOE writer printing tasks from starting. Current 
outstanding requests are still processed, but no new tasks are started. You must issue the 
STRSCN command to resume the JOE writer scanning task. The format of the STPSCN 
command is: 


SYSD,STPSCN 


STRSCN - Starting the Global JOE Writer Scanning Task 

The STRSCN command starts the CPMS/SYSD global JOE writer scanning task. You do 
not normally need to issue this command because the first JOE writer request 
automatically starts the global scanning task. You; only need to issue this command if the 
STPSCN command was issued to temporarily halt all the JOE writers. The format of the 
STRSCN command is: 


SYSD,STRSCN 


STRWTRST - Starting a JOE Writer 

The STRWTRST command starts one or more CPMS/SYSD JOE writers using the default 
selection and disposition parameters specified in the printer's table entry. The format of 
the STRWTRST command is: 


SYSD,STRWTRST,printer mask 
SWST 
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Wis pammetieii Specifies 

printer^mask The ID of the printer terminal you want to start a JOE writer 

for. You can specify a single GIGS printer terminal ID or a 
generic mask if you want to start more than one JOE writer. 
You can use a plus sign (+) or asterisk (*) in the printer 
terminal ID for generic matching. 

If you specify an actual printer ID, GPMS/SYSD starts the JOE . 
writer using the defaultselection and disposition options, 
regardless of the AUTOSTR'specification. If you specify a 
printer mask, GPMS/SYSD only starts the printer entries that 
have AUT0STR:=SW specified in PTBLMAIISJ. 



If the JOE writer selection and disposition options fail, GPMS/SYSD displays 
error messages and also sets them in the printer's table entry. You can use 
the PRTDSP command to view these messages. See the CPMS/SYSD 
Reference Manual for more information.about the PRTDSP command. 


SYSDTASK - Checking Auxiliary Tasks 

The SYSDTASK command checks the status of SYSD's auxiliary tasks. You can use this 
command for debugging purposes. The format of the SYSDTASK command is: 


SYSD(SYSDTASK [,task_id] 


This parameter: Specifies 

taskjdi The ID of the task you want to check as displayed on the 

Auxiliary Task Status Display screen. You: only need to specify 
the last character of the task ID. 

If you do not specify a task ID, SYSD displays the general status of all’auxiliary tasks in 
the following format 
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11/03/97 MVS/ESA VERSION OF CPMS/SYSD RELEASE 6.4.1 

MONDAY AUXILIARY TASK STATUS DISPLAY 

GENERAL COMMUNICATION AREA FOR ALL TASKS 
HEAD task;AREA FLAG 1 = 80 
A task:HAS BEEN INITIALIZED 
MAXIMUM NUMBER OF AUXILIARY TASKS = 0003 
ADDRESS OF FIRST TASK TABLE ENTRY = 00090360 

TASK-ID task;STATUS FLAGS LAST ABEND (R15) 

OSTK0001 ATCH WAIT NOTH NORM 000000 00000000 

OSTK0002 UNAT WAIT TERM NORM D37000 FFD37000' 

OSTK0003' ATCH WAIT NOTH NORM 000000 00000000 

* * * END OF DATA * * * 


PAGE 001 
14:26!33 


SYSD SYSDTASK 


If you specify a task ID, SYSD displays its status in the following format: 



11/03/97 MVS/ESA VERSION OF CPMS/SYSD RELEASE 6.4.1 PAGE 001 

MONDAY AUXILIARY TASK STATUS DISPLAY 14:30:03 


GENERAL AREA FOR TASK; OSTK0001 

THIS TASK WORK AREA ID = OSTK0001 

RETURN ADDRESS INTO TASK:= 0058AEF0 

ATTACHED TASK:TCB PTR = OO9CB0DO 

TASK BUSY ECB = 809CB048 

task;completed ECB = 40000000 

TASK TERMINATED ECB = 009E1B70 

CICS task;TWA PTR = 00000000 

ADDRESS OF NEXT TASK:TABLE ENTRY = 00090470 

LAST ABEND CODE = 000000 

R15 (REQUEST/RETURN CODE) = 00000000 

RO = 5011C56A 

R1 = 00C3AC00 

*** SVC EXECUTION *** 

COMMUNICATION FLAGS 

TASK HAS BEEN ATTACHED. 

AUX TASK CONDITION 

P/N 
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SYSDTEST - Verifying the Installation 

The SYSDTEST command verifies the installation process. The formatof the SYSDTEST 
command is: 


SYSD,SYSDTEST 


SYSD writes errors to the terminal you; issued the SYSDTEST command on and the 
master console. The following are possible errors and solutions: 

♦ If your terminal indicates the SVG was not properly installed, see "Troubleshooting 
SVC Errors" on page 49 for instructions. 

♦ If your terminal indicates the auxiliary task was not properly installed, reassemble 
SYSDOSTK. Make sure SYSDOSTK assembles properly and is in the STEPLIB library 
for GIGS. 

♦ If your terminal indicates the GWA date was not properly installed, change the value 
of the &CWADISP parameter in SYSDSETS to -1 and reassemble SYSDINIT. 

♦ If your terminal indicates improper JES2 variables, check the value of the &;JES2VER 
parameter in SYSDSETS and make sure the correct JES2 libraries were concatenated 
in the assembly PROCs. If you find an error, rerun the STGl ASM job. Then rerun 
the INSTCOMM and INSTJES2 jobs. 


SYSD0005 - Loading a New Copy of SYSD0005 

The SYSD0005 command dynamically loads a new copy of SYSD0005 resident in core. 
SYSD0005 contains the routines used throughout CPMS/SYSD that are dependent on the 
version of GIGS you are running. You would normally have to cycle GIGS to get a new 
copy. The format of the SYSD0005 command is: 


SYSD,SYSD0005 
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SYSD0074 - Loading a New Copy of SYSD0074 and SYSD0174 

The SYSD0074 command dynamically loads a new copy of both SYSD0074 and SYSD0174 
resident in core. SYSD0074 contains CPMS/SYSD's user exits. You would normally ha¥e to 
cycle CI£S to get a new copy. The format of the SYSD0074 is: 


SYSD,SYSD0074 


SYSD0137 - Loading a New Copy of SYSD0137 

The SYSD0137 command dynamically loads a new copy of SYSD0137 resident in core. 
SYSD0137 contains common GIGS subroutines used throughout GPMS/SYSD^ You would 
normally have to cycle GIGS to get a new copy. The format of the SYSD0137 command is: 


SYSD,SYSD0137 


SYSD0174 - Loading a New Copy ofSYSD0174 and SYSD0074 


The SYSD0174 command dynamically loads a new copy of both SYSD0174 and SYSD0074 
resident in core. SYSD0174 contains GPMS/SYSD^s general subroutines. You would 
normally have to cycle GIGS to get a new copy. The format of the SYSD0174 command is:: 


SYSD,,SYSD0174 


SYSPGMR - Setting All Security Bits 

The SYSPGMR command changes the GIGS security mask on the issuing terminal to 
allow all available functions. SYSD sets all security bits to Is for the terminal you issued 
the SYSPGMR command on. The format of the SYSPGMR command is: 


SYSD,SYSPGMR 
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TERM - Displaying and Changing the TCT 

The TERM command displays either a summary of alfthe entries in the TCT or a 
summary of the variable settings for a specific TCT entry. Each entry represents a terminal 
to CICS. You can also use this command to change a TCT entry's variable settings. The 
format of the TERM command is:: 


SYSDjTERM[,terrnihal_id] [,,subfunction] [,new_value) 


Caution 



The user must sign off and then sign on again for the alternate screen size to take effect. Be 
carefulwhen you use the MODx parameters. 


This parameter Specifies 

terminaMd The ID of the terminal you want to display or change. This 

parameter is required if you are changing the settings for a 
TCT entry. The default is a summary of all the entries in the 
TCT. 

If you do not know your terminal HD; type a question mark 
(?) on your terminal and press Enter. 

Use a plus sign (+) in any position of the terminal ID to match 
all the characters in that position. Use an asterisk (’^) to match 
any character in the terminal ID in that position and beyond. 

subfunctioni The subfunction you want to assign a new value to. The 

default is a summary of the variable settings for the TCT entry 
specified by the terminalMd'parameter. 

Type To 

AUTH Set all the terminal's TCTTE security bits to 

1. This feature is not supported for CICS 
version 3.2 and above. 

DGKYBD Toggles the dual-case keyboard indicator 

off and on., 



I 1 
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Type 

To 


EXTC 

Toggle the extended features indicators on 
and off. These indicators include color, 
extended: data streams, and highlighting. 
This feature is not supported for CICS 
version 3.2 and above. 


IN 

Change the terminal's status to in service. 


LTPN 

Toggle the light pen indicator off and on. 
This feature is not supported for CICS 
version 3.2 and above. 


MOD2 

Set the terminal's alternate screen size to 
zero. This feature is not supported for 

CICS version 3.2 and above. 


MOD3 

Set the alternate screen size to 32 rows by 
80 columns.,This feature is not supported 
for CICS version 3.2 and above. 

u 

MOD4 

Set the alternate screen size to 43 rows by 
80 columns. This feature is not supported 
for CICS version 3.2 and above. 


MOD5 

Set the alternate screen size to 27 rows by 
132 columns. This feature is notsupported 
for CICS version 3.2 and above. 


OUT Change the terminal's status to out of 

service. 

PRTV Change the terminal's priority to 

new_value. 

UCTRAN Toggle the uppercase translation indicator 
off and on. 


new_value The new value you: want to assign to a subfunction. For 

example, you can change the PRTY subfunction to a number 
from Oito 255., 
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TEST - Testing New Functions 

The TEST command tests new functions in GPMS/SYSD. You should only issue this 
command if you are familiar with CPMS/SYSDl The formatof the TEST command is: 


SYSD,TEST 


You:can specify any parameters that are allowed by the function you are testing. 

See "TESTGHG - Setting the TEST Function ID" for more information about dynamically 
assigning a function ID of TEST to a PPT entry. 


TESTCHG - Setting the TEST Function ID 

The TESTGHG command dynamically assigns a function ID of TEST to any PPT entry, 
When you issue the TEST command, the program assigned by TESTGHG executes. The 
format of the TESTGHG command is: 


SYSD,TESTCHG,program_id 


This parameter Specifies 

programjdi The 4- to 8-character name of the program you want to test. If 

you specify a 4-character program name, SYSD prefixes the 
specified name with SYSD to complete the name. 

See "TEST - Testing New Functions" for more information about testing functions. 
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The Bktch Work File utility provides functions that let you control the SYSD editor and 
SYSD/ATP browse work files from the batch environment. These functions are EDITINIT 
(El), EDITLIST (EL), and COPY. This chapter provides the JGL required to execute the 
Batch Work File utility and describes each function. 
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JCL for the Batch Work File Utility 

The following JCL executes the Batch Work File utility: 


//EXECWORK 

//STEPLIB 

//SYSPRINT 

//WORKIN 

//WORKOUT 

//ELDATA 

//ELREPORT 

//SYS IN 


EXEC PGM-SYSDWU01 
DD DSN=your,sysd.Loadlib,D1SP=SHR 
DD SYSOUT=A 

DD DSNsyour.workfile,DISP=OLD 
DD DSN=your.new.workfile,DISP=OLD 
DD DSNf=holdihg.file.. ..(definitions for a file) 
DD SYSOUT=A 
DD * 


*control statements 
* 


Depending on which function you are executing, not all of these DD statements are 
required. The description of each function tells you which control statements and DD 
statements are required. 


Caution 



To prevent the editor or browse work file from being corrupted accidentally, perform all 
functions with a DISP=OLD, Be extremely careful when performing the El function because 
there are no checks to make sure the work file is not active to CICS. If you perform a COPY 
function with an active work file, the new work file may not be valid. If you perform a batch 
work file function against an active CICS work file, you.may get unpredictable results. 
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EDITINIT (El) Function 

The EDITINIT function initializes a work file. The batch EDITINIT function provides the 
same functionality as the online function, except the batch function does not require you^ 
run the lEBDCS job first to write dummy records. It is normal for the EDITINIT function to 
get a D37 abend because writes are issued to the file until the end of file is reached. The 
EDITINIT function recovers from the D37 abend and continues processing. 


Required control statements 


FUNC=EI 


Tells the Batch Work File utility you want to initialize a work file. 


WORKNAME=fUe name 


Defines the FCT name CICS uses to access the work file. 

The FUNG=El and; WORKNAME control statements require the WORKIN DD 
statement, which defines the work file you want to initialize. 
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EDITLIST (EL) Function 

The EDITLIST function gets information about outstanding edit sessions. The batch 
EDITLIST function is very similar to the online function; The batch function also lets you 
create an intermediate file that contains information about the editor work file and the 
editsessions. You can sort and print this intermediate file and use it as input to a 
user-written program that provides control breaks, totals by user, and so on. 


Required control statements 


FUNC=EL 


Tells the Batch Work File utility you want to get information about the outstanding edit 
sessions. 


FORMAT=ELREPORT|EL0UT|ELIN|ELTOTAL 


Specifies the type of EDITLIST you want to perform. The following are the types of 
formats:: 


FORMAT=ELREPORT 


Creates a report of all outstanding edit sessions and totals for the entire work file. The 
FORMAT=ELREPORT statement requires the following DD statements; 


u 


This DD statement Specifies 

WORKIN The input work file. 

ELREPORT Where you want to write the report. 


FORMAT=ELOUT 


Creates fixed-length records that contain information about the work file. The first byte of 
each record indicates what type of record it is., 

If tHe first byte is The record is 

G'1' A header record that contains the dataset name of the 

work file. 
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Ifithe Hmt! bytie is The record is 

A detail record that contains information about an 
ou tstanding edit session. 

A total record that contains totals for the entire work file. 
See SYSD:MACLIB(ELDATA) for the DSECT of these intermediate records. 

The FORMAT=ELOlJT statement requires the following DD statements:: 

This DD statement Specifies 

WORKIN The input work file. 

ELDATA Where you: want to write the intermediate records. 

FORMAT=ELIN 

Processes the intermediate records created from a previous FORMAT=ELOUT. If you 
execute a sort between the FORMAT=ELOUT and FORMAT=ELIN, make sure you keep 
the first record in the file a record type 1 and keep the lastrecord in the file a record type 
7. The FORMAT=ELIN statement requires the following DD statements: 

This DD statement Specifies 

EliDATA The input file that contains the intermediate records. 

ELREPORT Where you want to write the report. 
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FORMAT=ELTOTAL 

Creates a report that only contains the totals of the work file. The FORMAT=ELTOTAL 
statement requires the following DD statements:: 

This [DB statement Specifies 

WO RKl N The input work file. 

EllRfiPORT Where you want to write the report. 

Optional control statements 


L/P=60 


Defines how many lines per page the output report will have. The default is 601 


USER=user id 


Selects a specific user for processing. You can specify a maximum of 50 users. You must 
specify each user on a new input record with the USER= control statement. For example: 


USER=BA 

USER=DD 

USER=AJ 



O’ 
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COPY Function 

The COPY function increases the size of the work file without having to end all: 
outstanding edit sessions first. You can also use the COPY function to create a new work 
file that has a larger block size without ending all outstanding edit sessions first. You can 
do both of these functions at the same time. 


The COPY function can onltf increase the work file's block size. If you increase the block size, ' 
you must, change the FCT definition. 



Required control statements 


FUNC=C0PY 


Tells the Batch Work File utility you want to perform a COPY function. The 
FUNC=GOPY statement requires the following DD statements: 


This DD statement 

WORKIN 

WORKOUT 


Defines 

The input work file. 
The output work file. 
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Installing S^SD/JFT 



You must install SYSD/JFT on CPMS/SYSD release 6.2 or above. 


If you are installing SYSD/JFT at the same time you install GPMS/SYSD release 6.2 or 
above, follow steps 1 through 6 in this chapter and then proceed with the normal 
GPMS/SYSD installation process in Chapter 2, Installing CPMS/SYSD: 

If you already have GPMS/SYSD release 6,2 or above installed, follow steps 1 through 9 in 
this chapter and then cycle GIGS. SYSD/JFT should be operational: 

The SYSD/JFT cartridge contains the following files: 


Pile name 

Library name 

Contents 

FILEOl 

SYSD.LOADLIB^ 

Additional executable programs: 
SYSD0143, SYSD0144, and JFTADD 

FILE02 

SYSD.SOURGE 

Additional programs: SYSD0143, 
SYSD0144, SYSDJENK, and 

JFTADD 

FILE03 

SYSD.USRLIB 

Additional USRLIB members:: 
JFTPi^NDS, JFTSKLDS, and 
JFTMSGDS 

FILE04 

SYSD.PANEL 

Panels 

FILE05 

SYSD.MESSAGE 

Messages 

FILE06 

SYSD.SKELETON 

Skeletons 
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Filename 

liibmnyname 

Contents 

FILE07 

SYSDiSAMPLE.PANEL 

Sample panels 

FILE08 

SYSD:SAMPLE.MESSAGE 

Sample messages 

FILE09 

SYSD.SAMPLE.SKELETON 

Sample skeletons 



Files 7 through 9 contain some sample panels and systems H&W's 
customers have developed. Currently, there is a pane! to execute SYSD/ATP 
(Access to CA-Panvalet) batch utilities. If you have installed the SYSD/ATP 
option,,these samples may be very useful. After reviewing the samples, you; 
can copy them to your panel, message, and skeleton libraries where you can 
test and change them. These three files are only intended to be samples. 


> To install SYSD/J FT 

1. Create and run the following JCL to allocate the SYSD panel, message, and 
skeleton libraries: 


//jobname 

JOB 

MSGCLASS=A,,CLASS=A 

// 

EXEC 

PGM=IEFBR14 

//SYSPRINT 

DD 

SYSOUT=* 

//PANEL 

DD 

DSN=your.SYSD.PANEL,VOL=SER=XXXXXX,. 

// 


UNIT=DISK,OISP=(NEW,,CATLG>„ 

// 


SPACE = (3120, (300,10,10)'), 

// 


DCB=(RECFM=FB,LRECL=80,BLKSIZE=3120); 

//MESSAGE 

DD 

DSN=your.SYSD.MESSAGE,VOL=SER=xxxxxx, 

// 


UNIT=DISK,DISP=(NEW,CATLG):,, 

// 


SPACE=(3120,<300,10,5)), 

// 


DCB=<RECFM=FB,LRECL=80,BLKSIZE=3120) 

//SKELETON 

DD 

DSN=your.SYSD.SKELETON,V0L=SER=XXXXXX,, 

// 


UNI T=D I SK:,D I SP=(,NEW,,CATLG) „ 

// 


SPACE=(3120,(300,10,5)), 

// 


DCB=(RECFM-FB,LRECL=80,BLKSIZE=3120) 


2. Create and run the following JCL to unload the cartridge. This replaces modules in 
your SYSD libraries. You7«ttst unload this SYSD/JFT cartridge in a libraiy; that is at 
CPMS/SYSD release 6.2 or above. 


82 


CPm®/SYSD® - Release 6.4.2 




Chapter 6 — lr\stallir)g SYSD/JFT 



//jobname 

JOB 

// 

EXEC 

//SYSPRINT 

DD 

//1N01 

DD 

// 

V0L=l 

//OUT01 

DD 

//IN02 

DD 

// 

VOL=! 

//OUT02 

DD 

//IN03 

DD 

If 

VOL=! 

//OUT03 

DD 

//IN04 

DD 

// 

V0L=: 

//OUT04 

DD 

//IN05 

DD 

// 

VOL=! 

//OUT05 

DD 

//IN06 

DD 

// 

V0L=l 

//OUT06 

DO 

//SYSIN 

DD 


MSGCIASS=A,.CLASS=A 

PGM=IEBCOPY 

SYSOUT=A 

DSN=FILE01, LABEL=(01 ,SL,EXPDT=98000):, 
mPE,UNIT=CART,OISP=(OLD„PASS): 
D!SP=SHR,DSN=your.SYSD.LOADLIB 
DSN=FILE02,LABEL=(;02,SL,EXPDT=98000), 
(JTAPE,,UMIT=CART,DISP=(OLD,PASS) 

DISP=SHR,DSN=your.SYSD.SOURCE 
DSN=F ILE03, LABEL=(;03, SL ,EXPDT=9BOOO), 
(JTAPE, UN I T=CART, DI SP=(OLD, PASS) 
DISP=SHR,DSN?=your.SYSD.USRLIB 
DSN=FILE04,LABEL=(04,SL,EXPDT=98000), 
^TAPE,UNIT=CART,PISP=(OLD,PASS) 
DI,SP=SHR,DSN=your.SYSD. PANEL 
DSN = FIUE05,LABEL=(05,SL,EXPDT=98000):, 
^TAPE,UNIT=CART,DISP=(OLD,PASS) 

DISP=SHR,PSN=your.SYSD.MESSAGE 
DSN = F1LE06,LABEL=(:06,SL,EXPDT=98000), 
JTAPE,UN.IT=CART,DISP=(OLD,PASS) 

DISP=SHR,DSN=your.SYSD.SKELETON 
* 


/* 

// 


COPY INDD=(<IN01,R>),OUTDD=OUT01 
COPY INDD=((IN02,R)),OUTDD=OUT02 
COPY INDD = ((IN03,R):),,OUTDD=OUT03 
COPY INDD = <:(IN04, R)),OUTDD=OUT04 
COPY INDD=<(IN05,R)),OUTDD=OUT05 
COPY INDD = (:(IN06,R)),OUTDD=OUT06 


O' 


3. Change the &FNGJFT parameter in SYSDSETS to 1i. 

4. Specify the dataset names of the panel libraries in SYSD.USRLIB(JFTPANDS). The 
first panel dataset name should be the panel dataset name you allocated in step 1. 


You can use the CPMS/SYSD $JFTPAN1 through $JFTPAN5 user profile variables 
to let users dynamically change the JFT panel dataset concatenation. 


5. Specify the dataset names of the message libraries in SYSD.USRLIB(JFTMSGDS). 
The first message dataset name should be the message dataset name you allocated 
in step 1. 


You can use the CPMS/SYSD $JFTMSG1 through $JFTMSG5 user profile variables 
to let users dynamically change the JFT message dataset concatenation. 


6. Specify the dataset names of the skeleton libraries in SYSD;USRLIB(JFTSICLDS). 
The first skeleton dataset name should be the skeleton dataset name you allocated 
in step 1. 


You can use the CPMS/SYSD $JFTSPCL1 through $JFTSKL5 user profile variables to 
let users dynamically change the JFT skeleton dataset concatenation. 



7. Add the PPT entries for the SYSD0143, SYSD0144, SYSDJLNK, and JFTADD 
programs. These entries must be defined as Assembler. 
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8. Use the SYSDNKM PROG to assemble SYSDINIT. 

9, Use the SYSDCMD PROG to assemble SYSD0074. 
10.. Gyde GIGS. 
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SmCEIi Parameters 



SYSD;USRLIB(STAGE1) contains the installation-dependent options that define JCL 
parameters and dataset names. This appendix documents the STAGEl parameters and 
their defaults. You can change the STAGEl parameters to reflect your environment. You 
can use the default values as a reference when setting these parameters. 



The parameter settings in STAGEl reflect the product as shipped. If you 
omit a parameter, GPMS/SYSD uses the default. 
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Parameters 

The following sections describes the STAGEl parameters. 


ACCTID - JOB Card Accounting Information 

Environments All 

Selection) status Required 


The ACCTID parameter defines the job accounting information CPMS/SYSD puts on 
generated JOB cards. Specify a single alphanumeric constant or a string enclosed by 
parentheses or apostrophes. If the JOB card requires apostrophes, use two apostrophes 
for each single one. 

For example; 


Specify 


To generate this JOB card 


ACCTID=(SYSD) 
ACCTID=<ABC,DEF>, 
ACCTID='GH1' 

ACCTID=' ' 'MN0,PQR" ' 


//JOBNAME JOB SYSD 
//JOBNAME JOB (ABC,DEF) 
//JOBNAME JOB GHI 
//JOBNAME JOB 'MN0,PQR' 


The default is ACCTID=(SYSD), 


AMODGEN - OS System Source Library 

Environments All 

Selection i status Required 

The AMODGEN parameter defines the OS system source library that contains 
non-SYSl.MACLIB OS function macros. The default is SYSI 1 .AMODGEN. 


86 


CPMS^/SYSD® ~ Release 6.4:2 




Appendix A - STAGE! Parameters 


Prior to XA version 2.2.3, this dataset was named SYSl.AMODGEN and it resided with 
your other OS distribution libraries (DLIBS). After XA version 2.2.3, the SYSl.MODGEN 
library was added to the standard OS libraries. The macros in SYSl.AMODGEN were 
moved to SYSl.MODGEN. 



If you set the &OSLEVEL parameter in SYSD;USRLro(SYSDSETS) to 2 or 
greater, you: must set the MODGEN parameter to SYSl .MODGIN and set 
the AMODGEN parameter to SYS1 .AMODGEN. 


ASM PROG - Assembler Program for Assembly PROCs 

Environments All 

Selection! status Required 


The ASMPROG parameter defines the name of the assembler program the GPMS/SYSD 
assembly PROCs execute. 

Specify For 

ASMA90) High-level assembler. This is the default for MVS/ESA version 5 

and OS/390. If you have OS/390 you must use ASMA90. 

lEUASM Assembler F. 

IEV90i Assembler H. This is the default for MVS/ESA version 4.3 and 

below. 


BRWSVOL - SYSD/ATP Browse Work File Volume Serial 

Environments All 

Selectioni status Required if you are installing SYSD/ATP 


The BRWSVOL parameter defines the volume serial number where SYSD/ATP's BDAM 
browse work;file resides. This is the volume where the dataset specified for the 
BRWSWRK parameter resides. This parameter is only used for SYSD/ATP The default is 
SYSDVli. 
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BRWSWRK - SYSD/ATP Browse Work File Dataset Name 

Environments All 

Selection! status Rfequired ifiyou are installing SYSD/ATP 

The BRW^SWRK parameter defines the dataset name of SYSD/ATP's BDAM browse work 
file. This parameter is only used for SYSD/ATP. The default is SYSD.BRWSWRKOl 

You must specify the volume serial number where this dataset resides for 
the BRWSVOIl parameter. 

CICSCLA - CICS Command’level Assembler Translator 

Environments All 

Selection I status Required 



The GICSGLA parameter defines the name of your current GIGS command-level 
assembler translator The default is DFHBAP1i$. 


CICSCSD - CICS System Definition File for RDO 

Environments All 

Selection! status Required if you are using the GIGS RDOTacility 


The GIGSGSD parameter defines the name of the current GIGS system definition file you 
use for the GIGS Resource Definition Online (RDO) facility. The default is CIGS.DEHGSD. 


CICSMAC - CICS Macro Library 

Environments All 

Seltectlbni status Required 


The GIGSMAG parameter defines the name of your current GIGS macro library. H&W 
does not putany modules in this library. The default is CIGS.SDFHMAG. 
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/ CICSOSJ " aCS Losd Librstry 

Environments All 

Selection! status Required 

The OGSOBJ parameter defines the name of your current GIGS load library. This library 
should contain the program specified for the GIGSGLA parameter. The command-level 
program assemblies use this library. H&W does not linkredihany programs to this 
LOADLIB; The default is GICS.SDFHLOAD. 


CICSSRC - CICS Source Library 

Environments All 

Selection! status Required 

The CIGSSRC parameter defines the name of your current GIGS source library. H«&W 
does not put any modules in this library.,The default is CIGS.SDPHSRG. 

CLASS - Execution Class for Stage 1 Jobs 

Environments All 

Selection! status Required 


The GLASS parameter defines the execution class stage 1 processing puts on the JOB card 
for all the jobs it generates. This should be a class that is single threaded because you 
must run the stage 1 jobs in the order they are generated. The default is A; 
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COPVLIB - C/CS Copy Library 

Environments All 

Selection I status Riequired 


The COPYLIB parameter specifies the name of a library to place CPMS/SYSD macro 
source for updating the GIGS FGT and DGT tables and if you are not using RDO the PPT 
and PGT tables. When you run the STGIASM job, it creates INSTGTBE based on your ' 
GIGS release. When you run the job in JNSTGTBL, it places the macro source for the 
tables in the library specified by this parameter. This library will also have to be 
concatenated into the SYSLIB DD statements of your DFHAUPLK orDFHAUPEE 
procedures when the GIGS tables are assembled. The default is SYSD.USRIilBi^ 


CSDGROUP - RDO Group Name for CPMS/SYSD^s Resources 

Environments All 

Selection I status Required 


The GSDGROEJP parameter defines the RE)0 group name for GPMS/SYSD's resources. If 
you: are not using RDO, specify NO^-RDO. The default is SYSD; 


For GIGS version 4.1 and above, you must use RDO, and you must specify a 
valid group name. 


CSDLIST - RDO List Name for SYSD Resources 

Environments All 

Selection) status Required 



The GSDEIST parameter defines your GIGS startup RDO list name. The SYSD group 
defined by GSDGROEJP is added to this list name so the SYSD resources will:be installed 
at GIGS startup. This parameter should be set the same as the GRPEIST parameter in the 
SIT If you are not using RDO for SYSD resource definition, the default is NO-RDO. If you 
are using RDO, the default is STARTU P; 
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DEST - Destination for Stage 1 Jobs 

Environments MVS (JES2) 

SellBGtibnistiatlis Optional 

The DIST parameter defines the destination for all the jobs stage 1 processing generates. 

If you specify a destination, CPMS/SYSD generates a /*ROUTE PRINT card for all the 
jobs. The defeult is no destination. 

EDIJVOL - SYSD Editor Work File Volume Serial 

Environments All 

Selection!status Required if you are installing the SYSD editor. 

The EDITVOL parameter defines the volume serial number where the SYSD editor's 
BDAM work file resides. This is the volume serial number where the dataset specified for 
the EDITWRK parameter resides. This parameter is only used for the full SYSD package. 
The default is SYSDVL. 

o 

EDITWRK - SYSD Editor Work File Dataset Name 

Environments All 

Seltection status Required if you are installing the SYSD editor 

The EDITWRK parameter defines the dataset name for the SYSD editor's BDAM work 
file. This parameter is only used for the full SYSD package. The defaultis 
SYSDiSYSDWRKOl 

You must specify the volume serial number where this dataset resides for 
the EDITVOL parameter. 
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JES2SRC —JES2 Soutce and Macro Dataset Name 

Environments MVS(JES2) 

Selection! status Required if you are installing JES options 

The JES2SRG parameter defines the dataset name for the JES2 source and macro dataset. 
The default is SYSl!.M;^PSR€. 

For OS/390, SYSLHASPSRC has been changed to 
SYSl.VnRxMO.SHASMAG, where niis the OS/390 
version number and x is the OS/390 release level. 

JES3SRC -JES3 Source and Macro Dataset Name 

Environments MVS (JES3) 

Selection I status Required if you are installing JES options 

The JES3SRG pararrieter defines the dataset name for the JES3 source and macro dataset. 
The default is SVS1 .ASPSRG. 



JOBNAME - Default Stage 1 Job Name Prefix 

Environments All 

Selection! status Required 


The JOBNAME parameter defines up to four characters that will be used as a prefix for all 
the job names stage 1 processing generates. GPMS/SYSD prefixes these characters to the 
job name to form unique job names. The default is SYSD. 
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JOBPARM -JOBPARM Parameters 

Environments All 

Selectloni status Optional 

The JOBPARM parameter defines the JOBPARM parameters for the JOBPARM statement, 
for all the jobs stage 1 processing generates. The parameters must be enclosed by 
apostrophes and can be up to 61 characters long. CPMS/SYSD appends the parameter to- 
/^JOBPARM. If you omit this parameter or set it to null, GPMS/SYSD does not generate a 
JOBPARM statement. 


LIST - Assembly Listings 

Environments All 

Selection I status Required 


The LIST parameter specifies if you want to generate the assembly listings when you 
assemble the programs. The default is NO. 


If set to YES, the CPMS/SYSD assembly jobs generate a great deal of output 
Make sure your system is prepared to handle the spool requirements. 



MODGEN ■“ OS System Source Library 

Environments All 

Selection I status Required for XA version 2.2.3 and above 


The MODGEN parameter defines the OS system source library that contains macros 
other than those found in SYSl.MAGLIB for various OS functions. 

Prior to XA version 2.2.3, this dataset was normally named SYSl.AMODGEN and it 
resided with your other distribution libraries (DLIBs).,With XA version 2.2.3, a new library 
was introduced called SYSl.MODGEN. You must concatenate SYSl.MODGEN ahead of 
your SYSl.AMODGEN library in allSYSD assembly PROCs. 

I Note ^s If; you set the &GSLEVEL parameter in SYSD.USRLIB(SYSDSETS) to 2 or 

^ greater, you must set the MODGEN parameter to SYSl .MODGEN and set 
the AMODGEN parameter to SYS1i.AMODGEN. 
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MSGCLAS - Output Message Class for Stage 1 Jobs 

Environments AH 


SelteGtion I status Required 


The MSGCLAS parameter defines the output message class GPMS/SYSD uses as the 
SYSOUT class for all the jobs stage 1 processing generates. The default is class A. 

PGMERID - Programmer Name for Stage 1 Jobs 

Environments All 

Selectioni status Required 


The PGMERID parameter defines the programmer name CPMS/SYSD puts on all JOB 
cards stage 1 processing generates. The default is SYSTEM-PROGRAMMER. 


PRIO - Job Priority for Stage 1 Jobs 

Environments All 

Selection I status Required 


The PMO parameter defines the job priority CPMS/SYSD puts on all JOB’cards stage 1 
processing generates. If set to 0; CPMS/SYSD does not generate a priority.,The default is Oi. 


PROCJLB - Create JCLLIB Statement 

Environments All that support the JCLLIB'statement 

Selection status Optional 


This parameter set to Yes causes a JCLLIB statementto be created in the set of job 
statements for each generated install job. Placement of the JCLLIB; statementis after any 
/* ROUTE and /*JOBPARM statements, but before any EXEC statements. The JCLLIB 
statement references the library defined by the PROCLIBt parameter. This facility allows 
you to place all of the procedures in the SYSD.USRLIB library which isolates them from, 
the rest of the system and other versions ofSYSD. ,H&W recommends that you set this to 
YES and set PROCLIBiTo SYSD.USRLIB. The default is YES. 
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PROCLIB - Procedure Library Dataset Name 

Environments All 

Selfection I status Required 

This parameter defines the library name where the operational procedures are placed.. 
When you run the STGIASM job, it creates the INSTPROC job. When you run the 
INSTPROC job, itcreates the operational procedures. The operational procedures are 
named SYSDCMPR', SYSDPRNT, and SYSDRDR> unless you have renamed them in the 
&PROC001, &PROC002, and &PRGG003 parameters in SYSDSETS. INSTPROC also 
creates the installation procedures that are placed in the library designated by PROCLIBT 
The default is SYS1.PROCLIB. 


PROCLIB! - Procedure Library Dataset Name for Installation 
Procedures 

Environments All 

Seleetiom status Required 


This parameter defines the procedure library where the installation procedures are 
placed. When you run the STGIASM job, it creates the INSTPROC job. When you run 
the INSTPROC job, itcreates the installation procedures. The installation procedures are 
named SYSDMAR SYSDCMD, SYSDNRM, and SYSDCSD, unless you have renamed 
them in the PROCNMS parameter in STAGEl below. 

If your operating system supports the JCLLIB statement, you should set this parameter to 
SYSD.USRLIB and set PROGJLB to YES, This action isolates the installation procedures 
from the rest of the system and other versions of SYSD. If your operating system does not 
support the JCLLIB statement, you should set this parameter to SYSl.PROCLIB and set 
PROCJLB to NO. The default is SYSD.USRLIB'. 


PROCNMS - Assembly Procedures 

Environments All 

Selection Status Required 


The PROCNMS parameter defines the names of the CPMS/SYSD assembly procedures. 
This parameter is a sublist of names containing the following entries: 
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♦ ■ The first entry defines the name of the procedure that assembles all of CPMS/SYSD's 

maps. The default is SYSDMAP; 

♦ The second entry defines the name of the procedure used to assemble all of 
CPMS/SYSD's CIGS command-level programs. The default is SYSDCMD. 

♦ The third entry defines the name of the procedure used to assemble programs that 
the CIGS translator does not need. The default is SYSDNRMi 

♦ The fourth entry defines the name of the procedure that assembles the GIGS PGT ‘ 
and PPT tables and migrates them to your GIGS system definition file. The default is 
SYSDCSDi 


REGION - Region Size for Stage 2 Installation Jobs 

Environments All 

Selection status Optional 


The REGION parameter defines the region size GPMS/SYSD puts on all JOB cards stage 1 
processing generates for the stage 2 processing jobs. The default is 3072K. 


SMPMTS - IBM Macro Library Override 

Environments All 

Selection status Required 


The SMPMTS parameter defines the dataset name of the library you wantto use to 
override the IBM macros. This library is concatenated in front of all IBM libraries. Use this 
parameter to point to your SMPMTS library. The defaultis SYSDiMAGLIBl 


If your company has any products that modify JES macro definitions, make 
sure the updated macros are available to the GPMS/SYSD installation 
process. 



SPCLMAC - Standard CPMS/SYSD Libraries Override 

Environments All 

Selfectibni status Required 
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The SPCLMAC parameter defines a dataset that is concatenated in front of all the SYSLIBi 
DDs the CPMS/SYSD assembly procedures use. This dataset can contain any updated 
user exits, macros, or copybooks you wantto use to override the standard CPMS/SYSD- 
libraries. The default is SYSD.USRLIB. 


SVCLIB - OS SVC Library 

invironments All 
Selection I status Required 

The SVCLIB parameter defines the dataset name of your OS SVC library. CPMS/SYSD 
assembles and link-edits an SVC to this LGADLIB. For MVS, this is normally SYS1.LPALIB. 
The default is SYS1.LPALIB. 

SYSDMAC - CPMS/SYSD Macro Library 

Environments All 

Selection! status Required 

The SYSDMAC parameter defines the name of the CPMS/SYSD macro library. The default 

is sysd.maciiib; 

SYSDMAP - CPMS/SYSD BMS Map Library 

Environments All 

Selection status Required 

The SYSDMAP parameter defines the dataset name of the CPMS/SYSD BMS map library. 
The defaultis SYSD.MAPIIB. 


SYSDOBJ - CPMS/SYSD Load Library 

Environments All 

Selection i status Required 
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The SYSDOBJ parameter defines the dataset name of the GPMS/SYSD load library. The 
default is SYSO yOADllI B* 

SYSDSRC - CPMS/SYSD Source Library 

Environments All 

Selection! stiatljs Required 

The SYSDSRC parameter defines the dataset name of the GPMS/SYSD source library. The 
default is SYSD.SOURGE. 

SYSDUSR - CPMS/SYSD User Source Library 

Environments All 

Selection! status Required 


The SYSDUSR parameter defines the dataset name of the CPMS/SYSD user source library 
that contains the source for the installation jobs. This library also contains the source for 
the macros, copybooks that were updated during installation, and user exits. The default 
is SYSD.USRlllBi 
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SYSDSnS Pmarfieters 


This appendix documents the SYSDSETS parameters you use to set CPMS/SYSD% 
installation-dependent options. You can use this appendix as a reference when you 
change any of the parameters in the SYSDSETS source member. The default values for 
these parameters are in SYSD.USRLIB(SYSDSETS). 

SYSDSETS is pulled into each of the SYSD assemblies through the SYSDGBLS macro. 
SYSD, GICS, JES, and operating system facilities and features are accessed or generated 
based upon the settings you: specify using SYSDSETS. 

There are two types of parameters in SYSDSETS. Primary-use parameters are marked as 
such. You change these parameters before stage 1 processingoccurs. You can’change 
the other parameters after stage 2 processing occurs to tailor CPMS/SYSD: 

The parameters are listed alphabetically. If you have any questions about them> call H&W 
Customer Support. These parameters, especially the primary-use parameters, affect the 
entire CPMS/SYSD installation. 

You can change most of the SYSDSETS parameters after CPMS/SYSD is installed. 
Instructions are provided after each parameter's description for changing the parameter's 
value. 


The parameter settings in.SYSDSETS reflect the product as shipped. If you 
omit a parameter, CPMS/SYSD uses the default. 
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Parameters 


The following sections describe each parameter. 



&ATRNID ’^Alternate Main Transaction ID 

The &ATRMD parameter defines an alternate main transaction ID for CPMS/SYSD. See 
the &MTRNID parameter on page 113 for more information about the main transaction' 
ID. Most companies set this parameter to D. If you change this parameter; 

1. Reassemble SYSDINIT. 

2. Update the PGT. 

3. Cycle GIGS. 


&CICSREL - acs Version 


Primary use 


The &CICSREL parameter defines the version of GIGS you are running. , Set &GICSREL to 
one of the following; 



GPMS/SYSD no longer supports versions of GIGS prior to 1 . 7 ., 



1.7.0; 

2 . 1 . 0 ) 

2;1i.1' 

2 . 1.2 

3.1.0) 

3.2.0) 

3.310) 

4.1 i.0: 

5.11.0) For Transaction Server 1.1 

5.2.0) For Transaction Server 1.2 

5.3.0) For Transaction Server 1.3 and newer 
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f . When you Upgrade CICS:: 

Before you upgrade GIGS, call H&W Gustomer Support or visit our World 
Wide Web site (http://www.hwGS.com) for the latest installation iiuformationi 



1. Update the &:GICSREL parameter to reflect the new version of GIGS. 

2. Update the following STAGEl parameters:: 

♦ GIGSGLA 

♦ GIGSGSD 

♦ GIGSMAG 

♦ GIGSOBJi 

♦ GIGSSRC 

♦ GSDFGTG 

♦ GSDLIST 

♦ GSDFGTG 

♦ GSDPPTG 

3. Rerun the STGIASM job.. 

/ 4. To reinstall the assembly PROGs, run the INSTPROG job. 

5. RunthelNSTGOPYjob. 

6. Run the INSTGOMM and INSTGIGS jobs. 

7. For GIGS version 2.1 and below, run the INSTGSD job. For GIGS version 3.1 and 
above, run the INSTUGSD job. 

8. If you are not using RDO, reassemble your PPT to account for any new or deleted 
programs. 

9. Gycle GIGS. 

10. Issue the SYSD,SYSDTEST command. 

&CMPNAME - Company Name 

The (StGMPNAME parameter defines the 60-character constant GPMS/SYSD puts in the 
title of all functional screens. Most companies set this constant to their company name. 
This parameter is required. Enclose the constant with apostrophes. 

If you change this parameter, reassemble SYSDINIT and cycle GIGS. 
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&DFTINDS - Default System Program Bit 

The &DFTINDS parameter defines the bit number that controls if a user is authorized for 
systems programmer functions. This number should be the same as the number specified 
for the SGTYKEY field of the DFHSNT macro. If you do not define other security bits for 
a function, SYSDINIT uses this default. 


If you change this parameter, reassemble SYSDINIT and cycle GIGS.. 



For GIGS version 3.2 and above, security bits are no longer supported. See 
SYSD.USRLIB for more information about CPMS/SYSD^s user exits and 
instructions on implementing security withoutusing security bits, 
specifically the FUNCOl and MENU02 user exits. 


&DSLSREF - Dataset Reference Date 

The &DSLSREF parameter specifies if GPMS/SYSD updates a dataset's last referenced 
date when the dataset is accessed from edit, browse, SYSD/JFT, or the utilities. If set to Y 
(Yes), GPMS/SYSD only updates the lastreference date once a day for any dataset. If set to 
N (No), GPMS/SYSD does not update the last referenced date. 

If you change this parameter, reassemble SYSDINIT and cycle GIGS. 


&DSRECAL - Restore Requested by User 

The &DSREGAL parameter specifies if users can request a restore for an archived dataset. 
If set to N (No)> users cannot request a restore for an archived dataset. If set to Y (Yes), 
users can request a restore for an archived dataset by replying to a prompt message. 

If you change this parameter, reassemble SYSDINIT and cycle GIGS. 


&EDTBLKS - SYSD Editor Work File Block Size 

PriinaFy use 
SYSD only 

The &:EDTBLKS parameter defines the block size of the SYSD'editor's BDAM work; file. 
The block size limits the number of records that can be edited. The block size can be any 
size froml024 up to the track size. H&W recommends you specify a block size of around 
4096, depending on the device type. Round up or down for best optimization of disk 
space. A block size of'W96 allows edit sessions of up to 16,895 records. The default is 4096; 


CPMS®/SYSD® ~ Release 6.4.2 


102 



Appendix B SYSDSETS Parameters: 


If you change this parameter:: 

1. Rerun the STGIASM job to create the FCT entry INSTGTBL needs and the JCL to 
create the file in the xxxxEWMC job in INSTFILE. 

2. Reassemble the FCT and re-create the file. 


&EDTENQT - Editor Dataset Type Enqueue 

SYSD only 

The &:EDTENQT parameter defines the type of enqueue the SYSD editor performs for 
the datasets users edit. 


Specify To 

NONE Allow multiple, concurrent edit sessions for a dataset member. SYSD 
issues a warning message if a user starts a new edit session for a 
member that someone else is already editing. 

SYSD Prevent two SYSD users in the same CICS region from concurrently 

editing the same dataset member. This is the default. 

TSO Use the TSO or SYSD enqueue type to prevent two SYSD and/or 

TSO/ISPF users from editing the same member. ISPF editing is only 
prevented as long as the CIGS address space is available. 

SYSD uses the SPFEDIT enqueue type to prevent concurrent updates 
to the member. 


If you change this parameter, reassemble SYSDINIT and cycle CICS. 


&EDTSAVE - Editor Save with RETURN Command 


SYSD only 

The &EDTSAVE parameter specifies if SYSD updates the current edit session when the 
user issues the RETURN command. If set to N (No), SYSD performs an ABORT and keeps 
the current edit session, but does not update the actual dataset or member. If set to Y 
(Yes), SYSD ends the current edit session and updates the actual dataset or member. 
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&FNCXXXX - System Global Parameters 

Primary use 

CPMS/SYSD is divided into options and classes of functions. The &FNCxxxx global 
parameters in SYSDSETS define these options and classes of functions to your system. 
You must only set the global parameters for the options you have licensed to t. Global 
parameters that are set to Oi(zero) are not installed. 

If you have CPMS licensed, set &FNGJES to l!. 

If you have the full SYSD package licensed, all the globals are available. Set the following 
parameters to 1; 

♦ &FNCCICS 

♦ &FNGDMS 

♦ &FNCEDIT 

♦ &FNCJES 

♦ &FNCMISG 

If you have SYSD/JFT licensed, set &FNGJFT to T. 

If you have SYSPC licensed, set &FNGSYPG to li. 


&FORMCHG - Initial Forms Change Request 

The &FORMGHG parameter specifies if GPMS/SYSD sends the forms change request the 
first time it accesses a printer after GIGS is cycled. The default is Y (Yes). 

\ No'® \ Prior to release 6.4 of GPMS/SYSD, GPMS/SYSD did not send a forms 

change request to the forms change terminal the first time it accessed a 
printer. If you do not want GPMS/SYSD to send the forms change request 
the first time it accesses a printer, set &FORMGHG to N (No). 
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&FORMMSG - Forms Change Message 

The &FORMMSCS parameter specifies if CPMS/SYSD sends the forms change message to 
the forms change terminal when it finds a change in forms. The default is Y (Yes). 

Q Prior to release 6.4.1 of GPMS/SYSD, GPMS/SYSD sent a message to the 
forms change terminal instructing the operator to change the forms and 
then reply to the forms change message. If you: do not want to send a 
message to the forms change terminal, set &FOm4MSG to N (No); 
GPMS/SYSD displays the message Waiting on Forms on Option 7, GPMS * 
Printer Table Display/Change. 


&GLB#PDB - Global PDDB Count 

The &GLB#PDB parameter defines the minimum number of datasets a job must have 
before CPMS/SYSD uses the global PDDB table. The default is 10Oi 


&GLBPDDB - Global PDDB Option 

The &GLBPDDB’parameter specifies if GPMS/SYSD uses the global PDDB table. You 
should only implement this parameter if you are running in a GIGS version 3 or 4 
environment. The default is N (No). 


&HELPDSA - Alternate Online Help Dataset Name 

The &HELPDSA parameter defines the dataset name for an optional alternate online help 
dataset. You can update the online help in this alternate dataset CPMS/SYSD searches the 
alternate online help dataset before it searches the dataset specified for the &:HELPDSN 
parameter. The alternate online help dataset must be cataloged. 

If you change this parameter, reassemble SYSDINIT and cycle GIGS. 


&HELPDSN - Online Help Dataset Name 


Primary use 

The &HELPDSN parameter defines the dataset name of the CPMS/SYSD online help 
dataset The online help dataset must be cataloged and should not be archived. Set 

&HELPDSN to the same name you used for SYSD.HELP during the installation. 

If you change this parameter, reassemble SYSDINIT and cycle GIGS. 
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&ITRNID - Auto-Initiate Transaction ID 

Primary use 

The &ITRNID parameter defines the auto-initiate transactionIDCICS uses. This HD must 
be the same as the ©'specified in the PCI Stage 1 processing generates the PGT entry for 
the auto-initiate transaction ro. Do not put transaction security on the PGT entry for this 
transaction. This is an internal transaction; the user does notenter it The default is SVSIl 

If you change this parameter: 

1. Reassemble SYSDINIT. 

2. Update the PGT. 

3. GycleGICS. 

&JES2ARA - JES2 SRB Queue Read Method 

The &JES2ARA parameter specifies if the SRB queue read method gets the MVS CSA area 
from above or below the 16 megabyte line. See the &JES2SRB parameter for more 
information about the SRB queue read mechanism; 

Specify To use 

0 The GSA area. 

1i The ECS A area. This is the default. 

H&W recommends you use this option for MVS/XA, MVS/ESA, and 
OS/390 environments. 


If you: change this parameter, reassemble SYSDINIT and cycle GIGS. 
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&JES2JBI - JES2 Job Name 


Primary use 

The &JES2JBI parameter defines the 4-character OS job entry subsystem; (JES) job name. 
CPMS/SYSD uses this job name to find JES2's address space in M¥S. This parameter is 
normally set to JES2, but you can set it to a secondary subsystem name for testing with a 
secondary JES2. See "Running CPMS/SYSD with a Secondary JES2 Subsystem" on page 
51 for more information. 

If you change this parameter, reassemble SYSDINIT and cycle CICS. 


&JES2SRB - JES2 SRB Queue Read Method 

The &JES2SRB parameter defines the method GPMS/SYSD'uses to get JES2 checkpoint 
information for spool display.. 

Specify To use 

0) The checkpointdataset read method. CPMS/SYSD gets the memory to 

hold the information from OSCORE. Use this method if you: are 
running JES2 as a secondary subsystem. 

H&W recommends you install with &;JES2SRB set to 0 until testing is 
complete. However if you have GS/390 2.4 or greater, &JES2SRB must 
be set to 1. 

l! The method that dispatches an SRB to the JES2 address space and 

moves the JES2 information to the MVS ECSA. You musthave 
sufficient ECSA defined atIPL time. You must also define a 
CPMS/SYSD subsystem'entry to use as an anchor for the pointers to 
the area in ECSA. See "Using the JES2 SRB Queue Read Method" on 
page 51 for more information. If CPMS/SYSDls running in multiple 
CICS address spaces, it uses this method to share the JES2 
information. Unlike the checkpoint dataset read method, there are no 
I/Os performed for this method. 


See "Calculating CPMS/SYSD's Memory Requirements" on page 42 for more information 
about the memory requirements for both methods. 

If you change this parameter, reassemble SYSDINIT and cycle CICS, The subsystem entry 
must already be in place in the Operating System^ 

The SYSD subsystem name as specified by the &SYSDSSI parameter must be added to 
the lEFSSNxx member of SYSl.PARMLIB. Then activate this parameter either by an IPL 
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or if you have OS/390 issue the command SETSSI ADD; SDBNAM1=SYSD; where SYSD 
is the parameter specified by &SYSDSSL 


&JES2VER -JES2 Wrsion 

Primmyuse 

The &JES2VER parameter defines the JES2 version you are running. Set this parameter to 
the value specified for the &VERSION JES2 parameter in the $MODULE, $HASPGBE, or 
IHASPGEN member of SYSl.HASPSRC. For OS/390, see the &J2LEVEL parameter of 
$MODIlJLE in SYSl.VnRxMO.SHASMAG, where ruis the OS/390 version number and x is 
the OS/390 release number. You can also find the version number at the end of the Speci/y 
Options message displayed on the console when you bring up JES2 after an.IPL. If you 
have the SYSD CORE command available, you can see the JES2 version by issuing 
SYSD,GORE,SSCT=JES2@14. 


Specify 

For 

Sets Internal Variable 

SP I 1 . 3.61 

SPl.3.6 

&JES2136 

SR2.1i.5. 

SP2;l.5XA 

&JES2136 

SP2.1.7 

SP 2.1.7 XA 

&JES2136 

SP 2.2.0) 

SP 2.2.0 XA 

&JES2220 

SP3.1.1I 

SP 3.1.1 ESA 

&JES2311 

SP3.1.3 

SP 3.1.3 ESA 

&JES2311 

SP4,1.0) 

SP 4.1.0 ESA 

&JES2410 

SP4;2.0) 

SP 4.2.0 ESA 

&JES2420 

SP’4;3iO) 

SP 4.3.0 ESA 

&JES2430 

SPS.I.O) 

SP 5.1.0 ESA 

&JES2510 

SP5.2;0) 

SP 5.2.0 ESA 

&JES2520 

SP5.3.0i 

SP 5.3.0 ESA 

&IES2530 

OS.l!.1i.O) 

OS/390 1.10 

&JES2530 
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Specify 

For 

Sets Internali Variable 

OS 1i.2.0i 

OS/3901.2.0 

&JES2530 

OS 1.3.01 

OS/390 1.3.0 

&JES2530 

OS2;4.0; 

OS/390 2.4.0 

&JES2604 

OS2;5.0) 

OS/390 2.5.0 

&JES^04 

OS 2.6.01 

OS/390 2,6.0 and newer 

&JES2604 


If you upgrade JES2:: 

L Update the &JES2VER’parameter to reflect the new version of JES2. 

2. Update the JES2SRe parameter in STAGE! to reflect the new JES2 macro library 
name. 

3. Rerun the STGlASM job., 

4. Reinstall the assembly PROCs in INSTPROC to point to the new JES2 library, 

5. Run the INSTGOMM and INSTJES2 jobs. 

6. Gycle CICS. 

&JESDFTC - JES Default Route Class 

JES3 only 

The &JESDFTG parameter defines the default route class GPMS/SYSD uses if the user 
does notenter a new class on the SPLRTE command. If you change this parameter, 
reassemble SYSDINIT and cycle GIGS. 


&JESDUMC -JES Dummy Class 

JES3 only 

The &JESDUMC parameter defines the dummy class where GPMS/SYSD initially sends 
jobs marked 'HOED-FOR4DISPLAY'. The SPLRTE command routes the job from this class 
unless the user overrides it. If you change this parameter, reassemble SYSDINIT and cycle 
GIGS. 
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&JESDUMD -JES Dummy Destination 

JES2 only 

The &JESDUMD parameter defines the dummy destination for JES2. The SPEGLN 
command deletes jobs that have this destination. This is the default destination for the 
SPLCLN command. See "Using the MVS Spool Display Facility gES2)" on page 40 for 
more information about overriding the default destination. 

If you change this parameter, reassemble SYSDINIT and cycle GIGS; 




&JESEXPR -JES Expiration Time 

JES2 only 

The &:JESEXPR parameter defines the JES2 JQE/IOE update expiration time in seconds. 
The time can be a number from 00!to 99i GPMS/SYSD only refreshes the JQB/JOE area 
after this interval expires. This saves overhead, but commands may not appear to take 
effect immediately. 

You can also use this parameter to define the refresh interval for JES2 printer display 
information. 

If you change this parameter, reassemble SYSDINIT and cycle GIGS, 


&JESJOBN - JES2 Job VSAM Submit Interface 

JES2 only 

The &JESJOBN parameter specifies if GPMS/SYSD uses the VSAM interface to submit a 
job. By using the VSAM interface, the job number is returned in the message. To use the 
VSAM interface, specify YES. To use the DGT interface, specify NO; H&W recommends 
setting this parameter to YES* 

If you change this parameter, reassemble SYSDINIT and cycle GIGS. 


&JESSBMT - JES Submit DCT Name 

Primary use 

The &JESSBMT parameter defines the GIGS DGT name GPMS/SYSD uses to submit jobs 
through the editor. GPMS/SYSD enqueues this 4-character name in GIGS to ensure single 
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threading. For the submit function to work properly, other tasks that access this DCT 
must enqueue in the same manner. Most sites set this parame ter to SYSD; 

If you change this parameter: 

1. Reassemble SYSDINIT. 

2. Update the DCT. 

3. Cycle CICS. 


&JESSUBO - JES Submit Option Flag 

The &JESSUBO parameter specifies if the CICS DCT submit entry is closed after a user 
submits a job. Leaving the DCT submit entry open creates less overhead. If set to NO, 
CPMS/SYSD leaves the entry open and puts a job separator card in the outputbetween 
jobs. If set to YES, CPMS/SYSD closes the DCT entry after each submit The defaultis YES. 

If you change this parameter, reassemble SYSDINIT and cycle CICS. 


&JESTYP -JES Type 

Primary use 

The &JESTYP parameter defines the OS job entry subsystem (JES) CPMS/SYSD uses. You 
must specify JES2;. 


&LOGACTV - Log Miscellaneous Data 

The &LOGACTV global parameter specifies if all the system changes SYSD performs are 
set to 1, SYSD sends a message defining the change to the transient data 
destination specified for the &LOGDEST parameter. 

If you change this parameter, reassemble SYSD0174 and issue the SYSD;SYSD0174 
command to dynamically load a new copy of SYSD0174. 


&LOGDEST - Log Destination ID 

The &LQGDEST parameter defines the 1- to 4-Gharacter transient data destination SYSD' 
uses to log system changes. Most sites set this parameter to CSTL You must set 
&LOGACTV to 1; for this to take effect. 
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If you change this parameter: 

1. Reassemble SYSD0174. 

2. Reassemble SYSDINIT. 

3. Cycle GieS. 



&MAXOSTK - Maximum Number of OS Subtasks 

Primary use 

The &MAXOSTK parameter defines the maximum number of QS subtasks SYSD starts in 
the CICS address space. The subtasks protect CICS from abends and OS waits because 
CPMS/SYSD uses OS facilities. SYSD loads these subtasks and work areas into OSCORE. 
You may need to add more memory to the CICS OSCORE parameter. If you do not have 
the SYSD/ATP option, H&W recommends the minimum value of 3. If you have the 
SYSD/ATP option, H&W recommends the minimum value of 7. 

If you change this parameter, reassemble SYSDINIT and cycle CICS. 


To increase OSCORE for CICS version 3 and above, you must change the 

SIT parameters that deal with the DSA sizes or increase the region size. ' \ 



&MAXSCAN - JOE Writer Scan Interval 

The &MAXSCAN parameter defines the maximum scan interval for a JOB writer. This is 
the maximum number of seconds between scans of the JES queue for selecting output to 
be printed on a JOE writer. The aging process uses this parameter to cut down resource 
usage if there are no output datasets to print The minimum interval is 0> the maximum is 
6001 The default is 120i 

If you update this parameter, reassemble SYSDINIT and cycle CICS. 


&MROTNID - Terminal-Owning Region Transaction ID 

MRO only 

The &MROTNID parameter defines the transaction ID CPMS/SYSD uses to translate 
uppercase and lowercase characters in an MRO environment Youmust define this 
transaction to each terminal-owning CICS region that accesses CPMS/SYSD. See 
"Supporting MRO" on page 47 for more information. 
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If you change this parameter, reassemble SYSDINIT and cycle CICS. 



This parameter is only required for €10 version 1,2, and 3. 


&MTRNID - Main Transaction ID 

Primary use 

The &MTRNID parameter defines CPMS/SYSD's main transaction ID. The default is 
SYSD. 

You can change this parameter to any 4-character name. The product transaction ID you: 
specify must be the same as the name in the PCT Stage 2 installation processing uses 
either the DFHPCT macro or RDO to create the PGT entry. You can put transaction 
security on the PGT entry for this transaction. 

If you change this parameter: 

1. Reassemble SYSDINIT. 

2. Update the PCT., 

3. Cycle GIGS. 


&MXAUXSZ - Maximum Size of Auxiliary Storage 

The &MXAUXSZ parameter defines the maximum size of auxiliary temporary storage. If 
you change this parameter, specify it in the format value‘88> where valUe is the size of the 
auxiliary temporary storage and 88 is the VSAM Groverhead;:for example, specify 
4096.88i 

H&W recommends you do not change this parameter. If you do, call H&W Customer 
Support for assistance. 


&NPAGCMD - BMS Next Page Command 

Primary use 

The &MPAGCMD parameter defines the BMS paging command. This command must be 
the same as the PGRET field in the GIGS SIT with an N appended to it. Normally this 
parameter is specified as P/N., 
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Also see the &RI?AGCMD parameter on page 117. 

If you change this parameter:: 

1. Reassemble the SYSDMOl and SYSDM03 maps. 

2. Rfeassemble the SYSDOOOO, SYSD0174, SYSD0137, and SYSDINIT programs. 

3. CydeGICS. 

&OSLEVEL - MVS Operating System 

Primary use 

The &OSLEVEL parameter defines the level of the operating system you are running. 
Specify For 

SETA Oi MVS non-SP or MVS/SP 

SETA 1, MVS/XA versions below 2.2 

SETA 2 MVS/XA version.2.2 

SETA 3 MVS/ESA version 3.1 

SETA 4 MVS/ESA version 4.1,4.2, or 4.3 

SETA 5. MVS/ESA version 5.1 

SETA 6) MVS/ESA version 5.2 or above and OS/390 version 1.1.0 and above 

If you: change this parameter: 

1. Rerun the STGIASM job. 

2. Reinstallthe assembly PROGs in INSTPROC. 

3. Run the INSTGOMM and INSTOS jobs. 

4. CydeGICS. 
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&OSTYP - Operating System 

Primary usQ 

The &OSTYP parameter defines the operating system SYSD is operating in. This 
parameter must be set to MVS. 


&PERANL - Performance Analyzer Available 


SYSD onl^ 

The (SePERANL parameter specifies if IBM's Performance Analyzer (PA) is active in the 
GKCS system. If the PA is not active, specify 0; If the PA is active, specify li. 

If you change this parameter: 


1. Reassemble SYSDINIT. 


2. Reassemble SYSD0014. 



If you: find an undefined label called DCAAZN when you reassemble 
. SYSD0014, change the &PERANL parameter to 0<or make sure the DFHPGR 
and DFHPCRA macros are in one of the concatenated libraries of the 
assembly procedures. In either case, reassemble SYSD0014. To Newcopy 
SYSD0014, you can issue the GEMT SET PROG(SYSD0014) NEW command 
or the SYSD PROG SYSD0014 NEW command. 


3. Gycle GIGS. 


&PQAUTO - Start CPMS/SYSD Auto-Start Printers 

The &PQAUTO parameter specifies if CPMS/SYSD starts all the GPMS/SYSD printers that 
have AUTOSTR=YES | PQ j SW defined imPTBLMAIN. If set to Y, CPMS/SYSD starts all the 
auto-start printers using the default selection criteria and SYSOUT disposition 
specifications. This is the default. See Appendix G, PTBLMAIN Parameters, for more 
information about the AUTOSTR parameter. 

If you change this parameter, reassemble SYSDINIT and cycle GIGS. 
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&PRNTACQ -Acquire CtCS SYSD Printers 

The fePRlsTTACQ parameter specifies if SYSD tries to acquire a printer if it is in service to 
CIGS, but released and disconnected from GIGS, before printing to it. The default is N 
(No)., 

Ptior to release 6.4.1, GPMS/SYSD did notissue a request to acquire a 
printer. This normally happened automatically when, GIGS found work for 
the device. If you do not want GPMS/SYSD to issue a request to acquire a 
printer, set &PRNTAGQ to N (No). 



&PROC001 - PDS Compression Procedure 

Primary use 

SYSD only 

The &PROG001 parameter defines the name of the procedure SYSD starts when a user 
compresses a PDS from any of the screens in Option 3, Perform utility functions. The 
default is SYSDCMPR., 

If you change this parameter: 

1. Reassemble SYSDINIT. 

2. Rename the procedure you installed in SYSD.USRLIB(INSTPROG). 

3. GycleGIGS. 

&PROC002 - PDS Print Procedure 

Primary use 

The &PROG002 parameter defines the name of the procedure SYSD issues a start 
command against when a user enters an OS print function. The default is SYSDPRNT. 

If you change this parameter:, 

1. Reassemble SYSDINIT.. 

2. Rename the procedure you installed in SYSD.USRLIB(INSTPROC). 

3. Cycle GIGS. 
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&PROC003 - Submit Reader Procedure 

Primary use 

The &PROC003 parameter defines the name of the procedure S¥SD issues a start 
command against when a user enters a submitfunction. The default is SVSDRDR. 

If you change this parameter: 

1. Reassemble SYSDINIT. 

2. Rfename the procedure you: installed in SYSD.USRLIB(INSTPROC). 

3. Cycle CICS. 

&RPAGCMD - BMS First Page Command 

Primary use 

The &RPAGCMD parameter defines the BMS paging command that displays the first 
page of data. This command must be the same as the PGRET field in the SIT with a 1: 
appended to it Normally this parameter is specified as P/l:. 

Also see the &NPAGGMD parameter on page 113. 

If you change this parameter: 

1. Reassemble the SYSDMOl and SYSDM03 maps. 

2. Reassemble the SYSDOOOO, SYSD0174, SYSD0137, and SYSDINIT programs. 

3. Cycle CICS. 

&SDDFTCL - Default Column Number 

The &SDDFTCL parameter defines what the Spool Display facility displays in column 1 
of the output If set to 1:, the Spool Display facility displays the carriage control in column 
one. If set to 2, the Spool Display facility display the first character of data in column one. 
H&W recommends you set this parameter to 1s. 



If you change this parameter, reassemble SYSDINIT and cycle CICS. 
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&SPCTNID - Transaction ID for SYSPC 

If you have H&W's SYSPC product on your system and plan on using it with 
CPMS/SYSD, the &SPGTMD parameter defines SYSPC's transaction ID: The default is 
PCSY. You can change this parameter to any 4-character name. This transaction ID must 
also be specified in the PCT 

If you change this parameter: 

1. Reassemble SYSDINIT. 

2. Update the PGT. 

3. Cycle GIGS. 


&STDFCB -JES Default FCB 

The &STDFCB global parameter defines the default FGB name GPMS/SYSD uses when an 
FCB is not specified in the JGL for a print dataset. This is the same as the &PRTFGB 
parameter in SYS1.PARMLIB(JES2PARM) plus the prefix FGB2, For example, if &PRTFCB 
is set to 6> set &:STDFGB to FCB26i There must be a member in SYSl.IMAGELIB with this 
FCB name. 


Note \ 


\ 


You can override this default for a specific printer by changing the DFTFCB 
parameter on the printer's entry in PTBLMAIN. 


If you change this parameter: 

1. Reassemble SYSDINIT. 

2. Reassemble SYSDPTBL. 


3. Cycle GieS. 


&STDFORM - JES Default Form 

The &STDFORM parameter defines the default form for the GS printer. For JES2, this 
parameter is normally specified as STD. 

If you change this parameter: 

1. Reassemble SYSDINIT. 

2, Reassemble SYSDPTBL. 
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3. Cycle GICS. 


&SVCNO - Special SVC Number 

Primary me 

The &SVCNO parameter defines the SVC number SYSD'requires to run. Choose an 
unused type 3 or 4 SVC in the range of 201^ to 255. You can check the OS SYSClMto find 
out what the SVG number is. Do not use an SVC number that ends in Osor a type 1 or 
type 2 SVC. 


If you previously installed GPMS/SYSD at release 6.0 or newer, you can use 
the SVG previously installed. Specify the same SVG number here and 
perform the INSTSVC later in the install. 

If you change this parameter: 



1. Rerun the STGIASM job to re-create the INSTSVC job. 

2. If you have OS/390, update SYSl .PARMLIB(IEASVCxx) with 
SVCPARM xxx,REPLAGE,TYPE(3), where xxx is the SVG number, 

3. Run the INSTSVC job. 

4. Reassemble SYSDINIT. 

5. IPL MVS with a GLPA. 


&SYSDATP - Editor Access to CA-Panvalet Libraries 


Caution 



CA-Panvalet is a proprietary product of Computer Associates, You must license it from them 
before you use the SYSD/ATP option. 


Primary use 

The &SYSDATP parameter specifies if you have installed the SYSD/ATP option. The SYSD 
distribution cartridge must contain the SYSD/ATP option before this parameter is 
effective. If you have installed SYSD/ATR set this parameter to Y. If you have not installed 
SYSD/ATR set this parameter to N. 
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If you change this parameters 

1. Reassemble SYSDINIT. 

2. Reassemble SYSD0074. 

3. If you change the &SYSDATP parameter from N to Y^ rerun the STC31ASM job to 
re-create SYSD.USRLIB(INSTATP), 

4. If you change the &SYSDATP parameter from.N to Y, run the jobs in lNSTATPi 

5. Cycle CICS. 


&SYSDSSI - Subsystem Interface Name 

The &SYSDSSI parameter defines a 4-character subsystem interface name for use by 
SYSD. It must be defined to MVS in SYSl.PARMLIB(IEFSSNxx). SYSD uses this 
subsystem entry to provide an interface for requests that require execution in the J1S2 
address space. This parameter is only valid if the &JES2SRB parameter is set to 1. Most 
companies set this parameter to SYSD. 

If you change this parameter, reassemble SYSDINIT and cycle CICS. The SYSD lEESSNxx 
member must be activated by an MVS IPL or by issuing the OS command SETSSI 
ADD/SUBNAME=SYSD; where SYSD is the subsystem name specified by this parameter. 


&UCBDYN ~ Dynamic Unit Control Blocks (UCBs) 

The &UCBDYN parameter specifies if you are using dynamic unit control blocks (UCBs). 
If set to N, CPMS/SYSD does not support dynamic UCBS. If you are running MVS/ESA 
version 5 or OS/390, CPMS/SYSD defaults to dynamic UCB support and this parameter is 
ignored. 


&USESYSN - Display SYSIN Datasets 

The &USESYSN parameter specifies if CPMS/SYSD displays SYSIN datasets. If set to N, 
CPMS/SYSD does not display SYSIN datasets. This parameter does not affect the menu 
system. 


If you change this parameter, reassemble SYSDINIT and cycle CICS. 
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PTBLMAJN Parameters 



PTBLMAIN defines the terminals users will print to. Terminals include printers, 3270 
devices, LAN printers, and any other device users send output to. In this appendix, the 
term printers is used to refer to all output devices. PTBLMAIN is copied into the 
SYSDPTBL assembly and becomes the SYSDPTBL load module. See 
SYSD;USRLIB{PTBLMAIN) for more information. 


You must have one $PTBL macro in PTBLMAIN for each printer users will print to. This 
appendix describes the parameters for the $PTBL macro. 



You may need a separate SYSDPTBL program and PTBLMAIN for each 
CICS region. See "Using Multiple CICS Regions" on page 43 for more 
information. You can also code the SYSD.USRLIB(PRTOOl) user exit to 
specify where you want a particular printer auto started from. 
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&PTBL Macro Format 


The format of the &PTBT macro is; 


$PTBL parameter 


You can use the PRTDSP function to display and change most of the parameters 
described in this appendix. This lets you tune and test a printer. See the CPMS/SYSD 
Reference Manual for more information about the PRTDSP command. 
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Parameters 


The following sections describe the parameters for the &PTBT macro. 


AIDLIMT - Outstanding CICS START Commands 

The AIDLIMT parameter defines the number of outstanding GIGS START commands the 
global JOE writer scanning task queues for the printer. If there are two outstanding GIGS 
JOE print tasks for a specific printer, GPMS/SYSD does not start the scanning task again 
until the current task is done. This minimizes GIGS interval control overhead. The valid 
range for this parameter is from 0 to lOl The default is 2. 


AUTOSTR - Automatically Starting Printer 

The AUTOSTR parameter specifies if GPMS/SYSD automatically starts a printer with its 
defaults. 


Specify 

NO 

PQ 

SW 


YES 


To 

Do not auto-start the printer. 

Start the hot writer when you start GIGS. 
Start the JOE writer when you start GIGS. 
Start the hot writer when you start GIGS. 



Youmust have define the SYSD0149 program in the GIGS PLT startup entry 
for this parameter to take effect. 


BUFSIZ - Physical Buffer Size 

The BUFSIZ parameter defines the printer's physical buffer size. This mustbe a number 
from 512 to 8192 and it must not exceed the size specified in the TGT or the printer's 
physical buffer size. The default is 19201 
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CARSIZ - Carriage Size 

The CAESIZ parameter defines the printer's carriage size. The default is T32; Otherwise, 
you must specify one of the following carriage sizes: 80> 132, or any number greater than 
132 and less than 256i 


CHGTERM - Forms Change Control Terminal 

The CHGTERM parameter defines the terminal that controls the GPMS/SYSD PRTJOB> 
PRTQUE, and STRWTR commands. GPMS/SYSD sends forms change messages to this 
terminal. The default is the terminal the PRTJOB/ PRTQUE, or STRWTR command was 
issued on. 

C l This parameter is required if printing will be started from a non-standard 

^ terminal; for example, from a DASD sequential terminal with the auto-start 
feature. When using auto-install, a physical location may not get the same 
terminal ID every time the terminal is logged on. If this is the case in your 
environment, see the &FORMMSG parameter in SYSDSETS for more 
information about how to bypass sending the forms change message to the 
forms change control terminal. To bypass the forms change messages for a 
specific printer, use the OPTS parameter described on page 127. 


CHKRESP - CICS Definite Response Write 

The CHKRESP parameter defines how often CPMS/SYSD issues a CICS definite response 
write. The frequency must be from Oito 255. The default is 0: 


DELAY 

The DELAY parameter defines the number of seconds delay between buffers. You should 
use this parameter when CRT-type line traffic has priority. The default is Ol 



You can also use this parameter to minimize buffering in CICS and VTAM 
since it provides a delay before sending each buffer. 


DFTDISP - Default SYSOUT Dispositions 



This parameter is only in effect for auto-start, PRTQUEST, STRWTRST, and 
menu system hot writer and JOE writer starts. 


The DFTDISP parameter defines the default SYSOUT dispositions for the hot writer and 
JOE writer. 
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I > 




Specify 

7b; 

NEWCLASS 

Rbute the JOE to a new class after itis printed. The new class is 
defined by the DFTRCLS parameter. 

NEWDEST 

Rdute the JOE to a new destination after itis printed. The new 
destination is defined by the DFTRDST parameter. 

NODISP 

Perform a dataset-level purge. The outputis not set to 
non-selectable during the print operation, which means other print 
tasks can select the same report. A CICS enqueue is not in place, 
which means other print tasks can select the same output. 

NONSEU 

Putthe JOE in the held queue after it is printed. The outputis set to 
non-selectable, which means other print tasks cannot select the 
same report. A CICS enqueue is in place during printing, which 
means other CICS writers cannot select the same output. 

PURGE 

Purge the JOE from the spool after itis printed. The outputis set to 
non-selectable, which means other print tasks cannot select the 
same report. A CICS enqueue in place during printing, which 
means other CICS writers writers cannot select the same output. 
This is the default. 


To specify more than one disposition, use the following format; 


D FTDISP=disposition+disposition 


DFTFCB - Default FCB 

The DFTFCB parameter defines the printer's default FCB. If specified, this FCB overrides 
the defaultFCB in SYSDSETS, You can use this parameter to set up different defaults for 
your printers. 


DFTRCLS - Default New Class 



This parameter is only in effect for auto-start, PRTQUEST, STRWTRST, and 
menu system hot writer and JOE writer starts. 




The DFTRCLS parameter defines the default new class the hot writer and JOE writer 
send output to after it is done printing. The outputis only sent to this new ouiputclass if 
the DFTDISP parameter is set to NEWCDVSS. 
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DFTRDST - Default New Destination 



This parameter is only in effect for auto-start, PRTQUEST, STROTRST, and 
menu system hot writer and JOE writer starts. 


The DFTRDST parameter defines the default new destination, the hot writer and JOE 
writer send output to after it is done printing. The output is only sentto this new 
destination if the DFTDISP parameter is setto NEWDBST. 


DFTSCLS - Default Classes 


This parameter is only in effect for auto-start, PRTQUEST, STRWTRST, and 
menu system hot writer and JOE writer starts. 

The DFTSCLS parameter defines the default classes the hot writer and JOE writer scan for 
when looking for output to print. 



DFTSDST-Default Destination 

This parameter is only in effect for auto-start, PRTQIJEST, STRWTRST, and 
menu system hot writer and JOE writer starts. 

The DFTSDST parameter defines the default destination the hot writer and JOE writer 
scan for when,looking for output to print. 



DFTSFRM - Default Form 



This parameter is only in effect for auto-start, PRTQUEST, STRWTRST, and: 
menu system hot writer and JOE writer starts. 


The DFTSFRM parameter defines the default form the hot writer and JOE writer scan for 
when looking for output to print. 


DFTSWTR - Default Writer Name 

The DFTSWTR parameter defines the default writer name the JOE writer scans for when 
looking for output to print. This parameter is used with the default destination, classes, 
and form. The default selection writer name is only used for JOE writers; not for hot 
writers (PRTQUE). 


= \ 
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DFTUCS - Default Universal Character Set 

The DFTUCS parameter defines the printer's default universal character set (UCS). You 
can use this parameter for the special printer setup control characters the IES205 user exit 
generates and to reset the printer's setup characters for other applications after printing is 
done. This parameter is only used with the OPTS=UCSeTL parameter. See the OPTS 
parameter on page 127 for more information. 


MASTERM - Master Terminal 

The MASTERM parameter defines the ID of the 3270 terminal authorized to issue 
commands for this printer. This parameter defines a controlling terminal in addition to 
the originating and GHGTERM terminals. To let any terminal issue commands for this 
printer, specify ^****\ CPMS/SYSD does not send forms change messages to this terminal. 


MAXLIN - Maximum Number of Lines 

The MAXLIN parameter defines the maximum number of lines processed with each print 
request issued from the spool display view. The default is 50;000i 


OPTS - Printer Options 

The OPTS parameter defines the printer's options. 


Specify To have the printer 


DISGON Disconnect from GIGS when printing is done. (VTAM only) 

EMGGBP Bypass all forms change requests. 

FRMFED Use form feed characters on printers that supportX'OC' as 'TOP OF 
FORM'. This speeds up the printing process and provides better 
top- of-form recovery. 


FRMPRT Process printer-attended forms changes. Printer PA keys are 
supported., 


PRMSEL Print the same forms together. (PQ'and SW only) 

(continued) 
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Specify 

Rm€MR 


To have the printer 

Use repeat-to-address control characters to compress printer output 
data streams. The RTAGMP and SGSCMP options are mutually 
exclusive. 



SGSGMP Use SGS horizontal tabs to compress printer output data streams. 

The SGSGMP and RTAGMP options are mutually exclusive. 

UCSGTL Issue leading and trailing control characters based on the UCS= 

parameter of the SYSOUT statement. 


The default is no printer options. 

To specify more than one option, use the following format: 


OPTS=option+option 


OPTS2 - Vertical Tabs from FCB Image 

You can specify the OPTS2=SETVRT parameter for an SGS printer entry to set vertical 
tabs from the FGB image. If you specify this parameter, channel skips are included in the 
print data stream. 


SCNDLY - Hot Writer Scan Delay 

PQ only 

The SGNDLY parameter defines the delay in seconds between scans of the job queue 
while the hot writer waits for data to print. You can use this parameter to control GPU 
overhead. The default is 1i20!seconds. 


SEPBCN - Beginning Separator Pages 

The SEPBGN parameter defines how many beginning separator pages the JES204 user 
exit prints. If set to 0> JES204 does not print any beginning separator pages. The default is 
01 


: I 
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SEPEND - Ending Separator Pages 

The SEPEND parameter defines how many ending separator pages the JES204 user exit 
prints. The default JES204 user exit produces JES2 look-alike separators. If set to 0) JES204 
does not print any ending separator pages. The default is 01 


TERMID - Terminal ID 


The TERMID parameter defines the printer's terminal ID. This parameter is required. 


TRMDEST - Terminal Destination 

The TRMDEST parameter defines the printer's terminal destination. 

Specify Fop a 

D' DGT table entry. 

T TCT table entry. This is the default. 

U 

TRMTYP - Terminal Type 

The TRMTYP parameter defines the printer's terminal type. Valid terminal types are:: 

ASIS Transfer without change. 

2741 

3262 

3268 

3284 

3287 

3289 If the device is defined as an SCS printer in GICS, this is the 

recommended terminal type. 

3767 

3774 
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INMM^I‘N Pammeters 


This appendix describes the parameters in SYSD.USRLIB(INITMAIN).,There is a; 
SYSDTABL entry in INITMAIN for each GPMS/SYSD function. You can update the 
SYSDTABL entries to change CPMS/SYSD's default security level and disable selected 
functions. Before making any changes, review the source for INITMAIN to determine the 
basic security for each function. 

If you change INITMAIN, you must reassemble SYSDINIT and cycle CICS. 
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Parameters 


The following fields for the SYSDTABL entry identify the function:; 




ENTYPE 

The ENTYPE parameter defines the type of function. Do not change this parameter. 

This value Means 

F Non-menu function 

II Internal 

M Menu system. 


FUNC 


The FUNC parameter defines the function code or function name. Do not change this 
parameter. 



REF 

The REF parameter defines up to four,,8-character names that identify menu functions.. 
GPMS/SYSD passes these names to the menu'exits. 


TITLE 


The TITLE parameter defines the function's title. Do not change this parameter. 


OPTIONS 


The OPTIONS parameter defines the functions' various link options. These are special 
switches thatdetermine how the function is handled. Set OPTIONS to one or a 
combination of the following: 



The 0, LINKDISA, LINKNDOC, and LINKINDS options are mutually 
exclusive. 
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Setitb 7b 


o; 


Do not set any special switches. 


IIINKOISA Disable the function so no one can use it. 


yiNKlNDS 


UINKNDOC 


SECFUN 


SECSUB 


Secure the function and the online help. Only authorized 
users matching the security mask set by the SECFDN and 
SECSUB parameters can use this function or display its online 
help. 

Secure the online help for this function, but not the function. 
Only authorized users can access the online help, but anyone 
can use the function if they know about it. 

Set the function-level security key as defined by the €ICS 
Signon Table. This is a 64-bit field. To change this field, specify 
the keys as a subparameter list; for example, specify 4>8>24: to 
set three keys. For the default, &DFTINDS, only bit 24 is set. 

You must specify LINKINDS in the OPTIONS field before 
security checking is done. Only users whose security matches 
the security keys can use this function. 

This is identical to SECFUN except it applies to the 
subfunction level. The AUTHCHK macro is required to check 
security using this entry. You must code this parameter if you 
want to use subfunction security. 

These security options only apply if you are at CICS version 
3.1.n or below. 


Caution 



The LINKNSCN option tells CPMS/SYSD to not scan for input parameters. The 
LINKINCM option indicates that it is a menu system option. They are not security switches. 
Do not change them. Unpredictable results will occur if you do. 
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User Exits 


The FUNCOl (non-menuifunctions) and MENU02 (menu functions) user exits perform 
security key processing if you are at GICS version 3.1 .n or below. Internal functions 
(ENTYPE=I) are not passed to the user exits.. 

For GIGS versions 3 and 4, there are examples in the FUNCOl and MENU02 user exits for 
calling an external security product to authorize users for specific functions. 
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Lj Examples 

The following are some examples: 


Example 1 

This example shows how to disable the CIC5TRAN function. H&W ships the GICSTRAN 
function as follows: 


SYSDTABL FUNC=(CICSTRAN,CICS), 

ENTYPE=F, 

OPSYS=ALL, 

PGM=SYSD0029, 

OPTIONS=LINKNSCN, 

SECFUN=<&DFTINDS), 

HELPNAME='CICSTRAN', 

TITLE='CICS - LIST TRANSIDS BY SIGNON' 


To disable the CIGSTRAN function, change the OPTIONS field as follows:: 



SYSDTABL FUNC=<CICSTRAN,CICS);, 

ENTYPE=F, 

0PSYS=ALL, 

PGM=SYSD0029, 

OPTIONS=LINKNSCN+LIIJKDISA„ 

SECFUN=('&DFTINDS):, 

HELPNAME='CICSTRAN', 

TITLE='CICS - LIST TRANSIDS BY SIGNON' 


You can use the same format to secure the online help (LINKNDOG) or secure both the 
online help and the function (LINKINDS). 


Example 2 

This example shows how. to change the function-level security for the GORE transaction. 
H&W ships the GORE transaction as follows with security set to the default key (24): 


SYSDTABL FUNe=(C0RE,JES):, 

ENTYPE=F,, 

OPSYS=ALL, 

PGM=SYSD0017„ 

OPTIONS=LINK1NDS, 

SECFUN-(&DFTINDS), 

HELPNAME='COR£', 

TITLE='OS - DISPLAY AND ZAP VIRTUAL STORAGE' 
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To change the security for the CORE transaction so usei^ who have a security setting of 
13,18, or 24 can use the CORE function, change the SECFTJN field as follows:: 


SYSDTABL FUNC=(C0RE, JES3:„ 

ENTYPE=F, 

OPSYS=ALL„ 

PGM-SYSD0017,, 

OPT IOMS-LINKINDS, 

SECFUN=(,13,18,24), 

HELPNAME='CORE', 

TITLE='0S - DISPLAY AND ZAP VIRTUAL STORAGE' 


This setting lets users who have a key of 13,18> or 24 display virtual.storage. 



The OPTIONS field must be set to LINKINDS before CPMS/SYSD checks 
function-level and subfunction-level security. 


Examples 

This example shows how to secure Option 0.1, JES/List Parameter Definitions. H&W ships 
Option 0.1 as follows: 


SYSDTABL FUNC=$PARM020,, 

REF=('PARMS'„'LIST'), 

ENTYPE=M„ * OPTION 0.1 * 

OPSYS=ALL, 

PGM=SYSD0128, 

OPTIONS=LINKNSCN+LINKINDS, 
SECFUN=!<1,&DFTINDS>, 

HELPNAME='$LISTOOO', 

TITLE='SYSD-LIST PARAMETERS' 



To secure Option O.l so only users who have CICS security bits 16 and 24 can access it, 
change the $PARM020 function as follows: 


SYSDTABL FUNC=$PARM020 

REF=( 'FARMS', 'LIST'),, 

ENTYPE=M, * OPTION 0.1 * 

0PSYS=ALL, 

PGMi=SYSD0128, 

0PTI0NS=LINKNSCN+LINKINDS, 

SECFUN=(16,24), 

HELPNAME='$LIST000', 

TITLE='SYSD-LIST PARAMETERS' 


/■ \ 
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Example 4 

This example shows how to change the default HELP function to MENU. If a user 
invokes SYSU fromia clear CICS screen, they get the menu system signon screen instead 
of the HELP screen. 


H&W ships these functions as follows:: 


SYSDTABL FUNC=HELP„ 

ENTYPE=F, 

OPSYS-ALL, 

PGM=SYSD0093, 

OPTIONS=0, 

SECFUN=(&DFTINDS), 

HLPNAME='HELP', 

ALIAS=(‘ ',H), 

TITLE='SYSD - DISPLAY DOCUMENTATION' 

SYSDTABL FUNC=MENU, 

ENTYPE=F, 

OPSYS=ALL, 

PGM=SYSD0117, 

OPTIONS=LINKINCM, 

SECFUN=(&DFTINDS), 

HLPNAME='MENU', 

ALIAS=CM), 

TITLE=‘SYSD - ENTER THE MENU DRIVEN CPMS/SYSD' 



To change the default function from HELP to MENU, change the ALIAS field for both 
functions as follows: 


SYSDTABL FUNC=HELP, 

ENTYPE=F, 

OPSYS=ALL, 

PGM=SYSD0093, 

OPTIONS=0, 

SECFUN=(&DFTINDS), 

HLPNAME='HELP' , 

ALIAS=(H), 

TITLE='SYSD - DISPLAY DOCUMENTATION' 

SYSDTABL FUNC=MENU, 

ENTYPE=F, 

OPSYS=ALL, 

PGMi=SYSD0117,, 

OPTIONS=LINiCINCM„ 

SECFUN=(&DFTINDS), 

HLPNAME='MENU',. 

ALIAS=C' ',M):, 

TITLE='SYSD - ENTER THE MENU DRIVEN CPMS/SYSD' 
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mD.USmm Mmbers 


This appendix provides a list of the members in SYSD.USRLIB you use to set options, 
submit installation jobs, and tailor GPMS/SYSD through user exits. 


u 
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Installation Parameters and JCL 

This section provides a summary of the members that contain the installation parameters 
and JCL. 


Member! name 

Description! 

Programs affected' 


Options that define the SYSD/ATP browse work file. 

SYSDBRWS 

INITMMN 

Options for security and environment 

SYSDINIT 

INSTATP 

Jobs that install the SYSD/ATP (Access to 

CA-Panvalet) option. 

n/a 

INSTGICS 

Job that assembles the programs that are dependent 
on the version of GIGS you are running. 

n/a 

INSTCOMM 

Job that assembles the programs common to all 
environments. 

n/a 

INSTGOPY 

lEBCOPY job that creates the modules that are 
dependent on the version of GIGS you are running. 

n/a 

INSTCSD 

Job that assembles the SYSD PCT and PPT table 
entries and migrates them to the DFHCSD file. 

n/a 

INSTGTBL 

Jobs that create the GIGS table entries. 

n/a 

INSTFILE 

Jobs that create files for SYSD. 

n/a 

INSTJES2 

Job that assembles the programs that are dependent 
on the version of JES you are running. 

n/a 

INSTMAPS 

Job that assembles the maps. 

n/a 

INSTPROC 

Job that adds assembly PROGs to PROCLIB; 

n/a 

INSTPROG 

Jobs that assemble all programs. 

n/a 

INSTSVC 

Job that assembles and installs the SVC. 
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Memtier name 

Bescriptibni 

Programs affected 

INSTUCSD 

Job that uses the GIGS batch GSD update utility to 
add, delete, update, and list SYSD resource 
definitions. 

n/a 

INSTOS 

Job that assembles the programs that are dependent 
on the version of the operating system you are. 
running. 

n/a 

PTBLMAIN 

Printer definitions. 

SYSDPTBE 

STAGEl 

Options that generate the JGL for stage 2 processing. 

n/a 

STGIASM 

Job that assembles STAGEl and creates stage 2 
installation members. 

n/a 

SYSDSETS 

Options for the environment. 

AH 

WORKMAIN 

Options that define the editor work dataset. 

SYSDWORIC 
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SYSD 

This section provides a summary of SYSD's user exits. 

To implement a user exit, uncomment the example you want to use or code your own and 
reassemble SYSD0074. To get a new copy of SYSD0074, cycle CICS or issue the 
SYSD,SYSD0074: command. See "SYSD0074 - Loading a New Copy of SYSD0074 and 
SYSD0174" on page 69 for more information about the SYSD0074 command. 

The following letters identify options in the user exit table: 


User Exits 




This lettdr; 

Means 

G 

Functional command 

D 

OS data management (SYSD only) 

E 

SYSD editor 

F 

JFT (Job and File Tailoring) 

J 

OS JES internals 

M 

Menu system; 

P 

Printers 



User exiti 

Option! 

Description! 

OS 

ATPDOl 

E 

Identifies the ATP datasets. 

All 

ATPD02 

E 

Identifies which.ATP datasets should have a global 
directory built at startup time. 

All 

ATPEXTOl 

E 

SYSD/ATP updates the ATP comment record when a user 
issues the SAVE command. 

All 

AUDIT 

D 

Audit trail logging for PDS changes. 

All 

AT TTnni 

JL-v-.'vJ.X 

J 

Updates the time interval for displays that dynamically 
invoke themselves. 

All 
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iiJseti exiti 

Option/ 

Bmcriptibni 

OS 

BRSEXTOl 

E 

Specifies the dataset name of the SYSD/ATP browse work 
file. 

m 

DSNOOl 

D 

Dataset security for inquiry only: 

All 

DSN002 

D>E 

Dataset security for updates and changes. 

All 

DSN003 

D,E 

Converts dataset names. 

All 

EDTEXTOl 

E 

Specifies the dataset name of the editor work file. 

All 

FUNCOl 

C 

Security for non-menu functions based on CICS TGT 
security keys or calls to an external security product. 

All 

JES201 

I 

Job name security for spool display for JES2. {Inquiry only) 

MVS 

JES202 

J 

SYSOUT dataset security for spool display or print for 

JES2. (Inquiry only) 

MVS 

JES203 

J 

Job name security for spool display for JES2. (Update only) 

MVS 

JES204 

J 

Separator page print routine. 

MVS 

JES205 

J 

UCS-driven printer setup characters. 

MVS 

JES206 

J 

Read-only security for JOE view and print, (Inquiry only) 

MVS 

JES207 

I 

Security for JOE route and purge. (Update only) 

MVS 

JFTMSGDS. 

F 

Message libraries for job and file tailoring. 

MVS 

JFTPANDS 

F 

Panel libraries for job and file tailoring. 

MVS 

JFTSKLDS 

F 

Skeleton libraries for job and file tailoring. 

MVS 

MENUOO 

M 

Menu system automatic signon user exit. 

All 

MENU02 

M: 

Security for the menu function based on CICS TGT 
security keys or calls to an external security product 

All 
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liJseti exiti 

Option! 

Descriptibni 

OS 

MEMJ03 

U 

Security for the menu: function based on control fields in 
the user profile. 

All 

MENU04 

M 

Deletes the temporary storage records if the current user 
does not own them. 

Alf 

MENU05 

M 

Security exit for queue IDs and SYSIDs. 

MVS 

MENU06 

M 

Security exit for internal queue ID names. 

MVS 

PRTOOl 

P 

Additional printer access security exit. 

All 

PRT002 

P 

Verifies the print tasks for the auto-install printers 
associated with a PG. 

All 

SUBOOl 

E 

SYSD editor submit^ exit. 

MVS 

SYSLOl 

J 

Gommand'security for SYSLOG. 

MVS 

VOLOOl 

D 

Specifies the UGB for displays that search,all the VTOGs 
on the system. 

All 


II, 
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Ediior and' Browse Work Files 


This appendix describes how to define the SYSD editor work files and the SYSD/ATP 
browse work file. 
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Appendix F - Editor and Browse Work Files 


Defining the SYSD Editor Work File 

WORi^MAIM defines the attributes for the editor work files. You must code one $WOBiC 
macro in WORiCMAIN for each editor work file. If you define more than one work file, 
update the EDTEXTOl user exit to tell SYSD which work file to select WORSSvIAIN is 
copied into the SYSDWORK assembly and becomes the SYSDWORK load module. 



You must have a separate SYSDWORiC load module and WOiyCMAIN for 
each CICS region. See 'Using the SYSD Editor" on page 53 for more 
information. 


SWORK FILE=file name 


This parameter Specifies 

file_name The 1- to 8-character DDNAME of the editor work file. This 

parameter must match the value of the DATASET= field of 
the SYSD editor's FGT entry and the DDNAME specified in 
the GIGS startup JCL. If you do not have a valid FGT and DD' 
statement for every $WORiC entry, you: may get unexpected 
results. 

H&W recommends you call the first work file SYSDWRKO and 
call subsequent work files SYSDWRK1 through SYSWRKm 
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Defining the SYSD/ATP Browse Work File 

BRWSMAIN defines the attributes for the SYSD/ATP browse work files. You must code 
one $WdRK macro in,BRWSMAIN for each SYSD/ATP browse work file. If you s define 
more than one browse work file, update the BRSEXTOl user exitto tell SYSD which 
browse work file to select BRWSMAIN is copied into the BRWSWORK assembly and 
becomes the SYSDBRWS load: module. 


You must have a separate SYSDBRWS load module and BRWSMAIN for 
each CICS region. See "Using the SYSD/ATP Browse Work File" on page 55 
for more information. 



$WORK FILE=ffle name 


This parameter Specifies 


file_name The 1- to 8-character DDNAME for the SYSD/ATP browse 

work file. This parameter must match the value of the 
DATASET= field of the SYSD/ATP browse FCT entry and the 
DDNAME specified in the GIGS startup JGL. If you do not 
have a valid FGT and DD statement for every $WORK entry, 
you may get unexpected results. 

H&W recommends you call the first browse work file 
SYSDBRSOiand call subsequent browse work files SYSDBRSk 
through SYSDBRSni 
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Appendix G 

Summary of Program! Modulm 


This appendix provides a list of CPMS/SYSD programs and describes their functions. The 
OS column of the table identifies the program's operating environment. Before youi 
compile these programs, set up SYSDSETS. Then assemble only those programs that 
apply to your environment. The Gass column identifies what type of program it is. 


This letter 

Means 

C 

CICS internals 

D 

OS data management 

E 

SYSD editor 

F 

JFT (Job and File Tailoring) 

I 

GPMS/SYSD internal control programs 

J 

OS JES internals 

M 

Miscellaneous 



Program! 

Class 

Description! 

OS 

SYSDATPM 

E 

Executable module for reading SYSD/ATE 

All 

SYSDATPl 

B 

Executable module for updating SYSD/ATE; 

All 

SYSDBRWS 

E 

SYSD/ATP's browse work file table. 

All 

SYSDINIT 

I 

SYSD's initialization and function table. 

All 


{ ] 
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SYSDOSTK I 


SYSDPRNT D 


PDS batch print. 


SYSDPTBL J 


SYSDPVTC D 


SYSDSRBl J 


SYSDSRB2 J 


SYSDWORK E 


SYSDXCTL I 


SYSDOOOO I 


SYSDOOOl 


SYSD0002 


SYSD0003 


SYSD0004 



SYSD0008 


SYSD0009 


SYSDOOlO 


SYSDOOll 


Printer table for spool print. 


Batch VTOC print. 


Get checkpoint information from JES2. 


Get outstanding operator replies. 


PDS editor work file table. 


Sample program to front-end GPMS/SYSD. 


Initial driver module. 


OS UGB'display. 


CICS PPT maintenance and display. 


OS list VTOG display. 


OS dataset DGB display. 


EXEG GIGS command subroutines. 


OS list PDS directory. 


OS submit a GIGS TS queue. 


GIGS last ASRA PSW and register display. 


Get a new copy of SYSD0005. 


OS locate a dataset (DLTA). 


OS catalog deletion. 


]vrvsgES2) 


I 
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Ptogmm Clkss Descriptioni OS 


SYSD0012 

D 

OS dataset scratch. 

All 

SYSD0013 

I 

SYSD program information display. 

All 

SYSD0014 

C 

GIGS statistics display. 

All 

SYSD0015 

J 

OS submit a GIGS ID queue. 

All 

SYSD0016 

C 

GIGS TGT maintenance and display. 

All 

SYSD0017 

e 

OS core display and zap. 

All 

SYSD0018 

J 

OS operator command processor. 

All 

SYSD0019 

c 

GIGS table and module address display. 

All 

SYSD0020 

D 

OS PDS alias assignment. 

All 

SYSD0021 

D 

OS catalog a dataset. 

All 

SYSD0022 

D 

OS PDS member display. 

All 

SYSD0023 

J 

OS spool JOE clean up. 

MVS (JES2) 

SYSD0024 

C 

GIGS temporary storage queue maintenance and 
display. 

All 

SYSD0025 

J 

OS spool route and purge. 

VSl 

SYSD0026 

I 

OS dataset find subroutines. 

All 

SYSD0027 

G 

GIGS PGT maintenance and display. 

All 

SYSD0028- 

G 

GIGS FGT maintenance and display. 

All 

SYSD0029 

G 

GIGS transaction code list by signon. 

All 

SYSD0030 

M 

Biorhythm chart. 

All 

SYSD0031 

J 

OS submit a dataset. 

All 
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Ptogmm 

Class 

Description! 

OS 

SYSD0033 

C 

CICS DCT mamtenance and display. 

All! 

SYSD0036 

1 

OS job status display., 

¥S1 

SYSD0037 

I 

OS job cancel. 

VSl 


I 

OS dataset read and write subprogram. 

Mi 



OS list catalog., 

Alii 


I 

OS detach SYSD separate T€Bi 

All: 


j 

OS job status display. 

MVS (JES2) 

SYSD0042 

I 

SYSDINIT date initialization. 

All 

SYSD0043 

j 

OS active task display. 

MVS 

SYSD0044 

j 

OS job queue display.. 

MVS (JES2) 

SYSD0045 

D 

OS dataset rename. 

All 

SYSD0046 

D 

OS dataset recatalog. 

All 

SYSD0047 

J 

OS spool display. 

MVS {JES2) 

SYSD0048 

J 

OS JQE browse and search. 

MVS(JES2) 


J 

OS job purge. 

MVS(JES2) 


J 

OS job route. 


SYSD0051 

I 

OS spool job cleanup. 


SYSD0052 

J 

OS JGT reader. 

MVSgES3) 

SYSD0053 

J 

OS job queue display. 


SYSD0054 

J 

OS spool display. 

MVS(JES3) 

SYSD0055 

J 

OS job purge and route. 

MVS(JES3) 
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Clkss 

Description! 

OS 


J 

OS job status display. 

M¥SgES3) 


J 

OS spool print initiator. 

VSl 


J 

OS spool printer. 

VSl 


J 

Print purge program; 

All 


J 

OS spool print initiator. 

MVS gES2) 

SYSD0061 

J 

OS spool printer. 

MVS gES2) 

SYSD0062 

I 

OS spool print initiator. 

MVS gES3) 

SYSD0063 

J 

OS spool printer. 

MVSgESS) 

SYSD0064 

G 

GIGS trace table display. 

All 

SYSD0065 

J 

OS spool print forms change reply. 

All 

SYSD0066 

J 

OS spool dataset summary display. 

MVSgES2) 

SYSD0067 

I 

SYSDTASK status display. 

All 

SYSD0068 

I 

SYSDTEST function. 

All 

SYSD0069 

D 

OS print function. 

All 

SYSD0070 

J 

Get checkpoint information through SRB; 

MVS gBS2) 


J 

Get checkpoint information from dataset. 

MVSgES2) 


J 

Display job output elements. 



J 

Reset checkpoint information common area. 



I 

General user exits. 

All 

SYSD0075 

J 

Print queue start. 

MVS gES2) 

SYSD0076 

J 

Print queue printer. 

MVS gES2) 
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Ptogmmi 

Class 

[Description! 

OS 



Print queue terminator. 

All 


D 

Display any DASD record., 

All 


D 

Compress a PDS. 

All 


J 

Display outstanding operator requests. 

MVS 

SYSD0081 

J 

Display JES2 spool block.by MTTR. 

MVS(JES2) 

SYSD0082 

C 

Display link pack area directory. 

MVS 


J 

Cancel a job. 

MVSgiS2) 

SYSD0084 

J 

Hold a job. 

MVS(JES2) 

SYSD0085 

J 

Release a job. 

MVS (JES2) 

SYSD0086 

J 

Display a job's JES2 control blocks. 

MVSaES2) 

SYSD0087 

J 

Display a job's JESl control blocks. 

VSl 

SYSD0088 

J 

Display JESl spool blocks by TTRC. 

VSl 

SYSD0089 

J 

Display JESl job queue blocks by TTRC. 

VSl 

SYSD0090 

J 

Print queue start. 

VSl 

SYSD0091 

J 

Print queue printer. 

VSl 

SYSD0092 

e 

Display link pack area directory. 

VSl 

SYSD0093 

I 

Help processor. 

All 

SYSD0094 

J 

Hold a job. 

VSl 

SYSD0D95- 

J 

Release a job. 

VSl 

SYSD0096 

J 

Display OS active tasks (dynamic). 

VSl 

SYSD0097 

J 

OS job route. 

VSl 
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Program! 

Clkss 

Bescription) 

OS 

SYSD0098 

J 

Display OS active tasks (dynamic). 

MVS 

SYSD0099 

I 

Change TEST function for debugging. 

All 

SYSDOlOO 

I 

SYSPGMR! security set function. 

All 

SYSDOlOl 

D 

OS PDS member deletion. 

All 

SYSD0102' 

D 

OS PDS member rename. 

All: 

SYSD0103 

I 

Additional SYSD and CIGS shutdown program. 

All 

SYSD0104 

J 

JES2 general subroutines. 

MVS(JES2) 

SYSD0105 

C 

Display GIGS allocated datasets. 

MVS 

SYSD0106 

J 

Printer status display. 

AH' 

SYSD0107 

J 

Print hold command. 

All 

SYSD0I08 

J 

Print cancel command. 

All 

SYSD0109 

J 

Print adjust command. 

All; 

SYSDOllO 

D 

Uncatalog a dataset. 

All 

SYSDOlll 

D 

OS catalog disconnect GVOL (DRPX). 

All 

SYSD0112 

D 

OS catalog index deletion (DLTX), 

AH 

SYSD0113' 

J 

VM reset. 

All 

SYSD0114 

I 

End auto. 

All 

SYSD0115 

I 

Non-swap.. 

AH 

SYSD0116 

I 

Get a new copy of SYSD0137. 


SYSD0117 

I 

Menu for password and log on. 


SYSD0118 

J 

VM command. 

AH 
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Ptiogrami 

€lkss 

Bescrsiptibni 

OS 

SYSD0119 

I 

Get a new copy of both SYSD0074 and: SYSD0174. 

m 

SYSD0120 

I 

Display initial menui 

All 

SYSD0121 

I 

Parameter change and: display menu: (Option 0). 

All: 

SYSD0122 

J 

Display active jobs (Option 4). 

MVS(JES2) 

SYSD0123 

J 

Display queue (Option 5).. 

MVSaES2) 

SYSD0124 

I 

Display JOEs (Option 6). 

M¥S (JES2) 

SYSD0125 

I 

Display printer summary (Option 7). 

Alf 

SYSD0126 

I 

Display and change PF keys (Option 0.2), 

All 

SYSD0127 

I 

Display and change general parameters (Option 0.0). 

All 

SYSD0128 

I 

Display and change the JES and list parameters 
(Option 0.1). 

All 

SYSD0129 

J 

Spool display dataset summary. 

MVS(JES2) 

SYSD0130 

J 

Spool display. 

MVS(JES2) 

SYSD0131 

J 

Spool print initiator. 

MVS aES2) 

SYSD0132 

I 

SYSD user file maintenance (Option U). 

All 

SYSD0133 

I 

Help display program (Option T). 

All 

SYSD0136 

I 

Transfer control program to front-end GPMS/SYSD. 

All 

SYSD0137 

I 

GIGS-dependent subroutines. 

All 

SYSD0138 

I 

Uppercase and lowercase input with MRO. 

All 

SYSD0139 

M 

Primary Menu (Option G). 

All 

SYSD0140 

J 

JES2 printer display. 

MVS 
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Ptograni! Clkss Description,’ 


SYSD0141 

I 

Hot writer auto-start. 

MVS 

SYSD0142 

J 

Active SYSLOG display. 

MVS gES2) 

SYSD0143 

F 

SYSD/JFT (Job and File Tailoring). 

AH 

SYSD0144 

F 

SYSD/JFT parameter (Option 0.3). 

All: 

SYSD0145 

I 

Display and change the PUT and GET queue IDs 
(OptionO.4). 

All 

SYSD0146 

C 

Display interval control elements. 

All: 

SYSD0147 

M 

Display modified link pack area. 

All 

SYSD0148 

J 

Submit PDS member. 

All 

SYSD0149 

C 

Startup PLT 

All 

SYSD0150 

C 

Display automatic initiate descriptors. 

All 

SYSD0151 

M 

Drives the START command. 

All 

SYSD0152 

D 

Display OS enqueues. 

All . 

SYSD0153 

D 

Display and change batch print parameters (Option 
0.5). 

All 

SYSD0154 

J 

JOE spool printer. 

MVSQES2) 

SYSD0155 

J 

JOE writer scanner. 

MVSgES2) 

SYSD0156 

J 

Start JOE spool writer. 

MVSgES2) 

SYSD0157 

J 

Stop single JOE spool writer. 

MVS(JBS2) 

SYSD0158 

J 

Start and stop a single JOE writer scanner. 

MVS gES 2 ) 

SYSD0174 

I 

General subrou tines. 

All 

SYSD0300 

D 

Utilities - selection.menu (Option 3). 

All 


LJ 
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Program 

€tkss 

Bescriptloni 

OS 


sysDosio 

D 

Utilities - library management (0|3tion 3.1). 

All 


SYSD0320 

D 

Utilities - dataset utilities menu (Option 3.2). 

All 


SYSD0321 

D 

Utilities - dataset information display (Option 3.2.B). 

All 


SYSD0322 

D 

Utilities - allocate utility display (Option 3.2.A). 

All 


SYSD0323 

D 

Utilities - catalog utility display (Option 3.2.G). 

All 


SYSD0329 

D 

Utilities ~ dataset functions. 

All 


SYSD0340 

D 

Utilities -LISTOYT utility display (Option 3.4). 

All 


SYSD0370 

D 

Utilities - VTOC utility display (Option 3.7). 

All 


SYSD03T0 

D 

Utilities - trace table capture. 

All 


SYSD03TM 

D 

Utilities ~ trace table menu format. 

All 


SYSD03U0 

D 

Utilities - system device unit display (Option 3.U). 

All 


SYSD0900 

I 

Secured SVG. 

Air 


SYSD090M 

I 

SYSD/ATP separate OS task -Read^ 

All 


SYSD0901 

I 

SYSD/ATP separate OS task - Update. 

All 


SYSD091M 

I 

SYSD/ATP separate OS task-Read. 

All 


SYSDIOOO 

E 

Initialize editor work dataset. 

All; 


SYSD1040 

E 

List all current edit sessions. 

All 


SYSD1060 

E 

Delete outstanding SLAM browse sessions for 
SYSD/ATP 

All 


SYSD1070 

E 

Build global SYSD/ATP directory tables. 

All 


SYSD1080 

E 

SLAM I/O routines. 

All 
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Ptogmtrii Glass^ Descriptiom Qg 


SYSD1090 

E 

SEAM directory routines. 

All 

SYSDllOO 

E 

SEAM record VO routines. 

Alf 

SYSDlllO 

E 

SEAM keyed record VO routines. 

All: 

SYSD1120 

E 

SEAM file manipulation routines. 

All 

SYSD1121 

E 

SEAM file manipulation routines. 

All 

SYSD1500 

E 

Editor - menu driver (Option 2). 

All: 

SYSD1510 

E 

Editor - PDS directory display. 

All 

SYSD1520 

E 

Editor - session display (Option 2.S)., 

All: 

SYSD1530 

E 

Browse - menu: driver (Option 1). 

All 

SYSD1540 

E 

Browse - PDS directory display. 

All 

SYSD1550 

E 

Editor-main. 

All 

SYSD1551 

E 

Editor command table. 

All 

SYSD1552 

E 

Editor - line command routines. 

All 

SYSD1553 

E 

Editor - block command routines. 

All 

SYSD1554 

E 

Editor - primary command routines. 

All 

SYSD1560 

E 

Editor - external copy menu. 

All 

SYSD1570 

E 

Editor - profile display. (Not currently used) 

All 

SYSD1580 

E 

Btowse - main. 

All 


O’ 
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System Abends and Emii Codbs 


This appendix provides a list of the GIGS or system abends that may occur while 
operating CPMS/SYSD, It identifies the issuing macro or program, describes the reason 
for the abend, and provides the corrective action to take. If any unlisted abends occur, call 
H&W Customer Support immediately. 


Abend code 

Abend! type 

Issued by 

Reason/Corrective actibni 

EOVS 

GIGS 

$EOV 

A SYNAD error occurred on a dynamic exception, 
but a SYNAD exit was not generated for the 
program. 

If the problem persists, call H&W Customer 

Support. 

J#2A 

GIGS 


A read to the GPMS/SYSD JES work area failed. 

Try issuing the JES2FREE command. If the problem 
persists, call H&W Customer Support. 

J#2B 

GIGS 


A read to the GPMS/SYSD JES work area failed. 

Try issuing the JES2FREE command. If the problem 
persists, call H&W Customer Support. 

OVFL 

GIGS 


SYSD0058 found a buffer overflow condition while 


outputting data. 


If the problem persists, call H&W Customer 
Support. 
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Abend! code 

Abend! type 

Issuedlby 

Reason/Gomective actioni 

PANE 

GIGS 


An internal error occurred in SYSD/fFE 

Get the dump and callH&W Customer Support 

TIME 

GIGS 

SYSD0042 

SYSD0042 failed when it issued an interval control 
■ START to re-initiate itself, on the next hour. 

Make sure you have activated interval control 
processing in your GIGS. 

UCTN 

GIGS 

SYSDi550 

A potential storage violation was found while 
translating data to uppercase. 

If the problem persists, call H&W Customer 

Support 

WKMl 

GIGS 

SYSD0063 

One of the spool print programs found a buffer 
overflow condition while outputting data. 

If the problem persists, call H&W Customer 

Support 

001 

GIGS 


SYSDOOOO failed to attach the SYSDOSTK program. 

Make sure the SYSDOSTK program is in 
SYSD.LOADLIB and an authorized 

SYSD.LOADLIB is in the STEPLIB library 
concatenation for GIGS. 

099 

GIGS 

$ERROR 

A permanent error occurred in a program. 
CPMS/SYSD usually displays an error message on 
the terminator printer. 

Review the error message on the terminal or 
printer. If the problem persists, call H&W Customer 
Support 

501 

GIGS’ 


SYSD0038 found an invalid identification of 


OSCORE work area or the SYSD/ATP option has 
insufficient GICS OSGORE. 






Increase the GIGS OSCORE to accommodate the 
SYSD/ATP option. 
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Abend code Abendltype Issued by R^ason/Corrective actioni 


A read of the CPMS/SYSD JES workarea failed. 

This frequently is an indication that SYSD was 
assembled with JES2 libraries that are not 
consistent with &JES2¥ERxin SYSDSETS in 
SYSD.USRLIB.Similarly itmay indicate the JES2 
that is running is not consistent with the 
assemblies. 


If you have recently installed CPMS/SYSD; issue 
the SYSDTEST command which may provide 
additional information. 

If you have been successfully running 
CPMS/SYSD, issue the JES2FREE command. This 
code may indicate a problem with the JES2 check: 
point information. 


If the problem persists, call H&W Customer 
Support. 


601 

GICS 

The GPMS/SYSD JES work area had an invalid area 
ID. A storage violation may have occurred.. 

If the problem persists, call H&W Customer 

Support. 

602 

CICS 

SYSD0070 could not find the SYSD SSCT. 

Make sure you have installed the subsystem 
interface in the Subsystem,Name Table (SSNT) 
correctly. See "Using the JES2 SRB Queue Read 
Method" on page 51 for more information. 

603 

CICS 

The release of the GPMS/SYSD work area failed or 


there was not a PPT entry for SYSDSRBl. 
Make sure there is a PPT entry for SYSDSRBl. 
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Abendicod& 

Abends type 

Issuedby 

Reason/Corrective action/ 

604,604A 

GIGS 


GPMS/SYSD had to waittoo long to gain control of 
the GPMS/SYSD JES work area. 

Try issuing the JES2FREE command. If the problem 
persists or happens often, call H&W Customer 
Support. 

605 

GIGS 


GPMS/SYSD had to wait too long to gain control of 
the GPMS/SYSD JES work area. 

Try issuing the JES2FREE command. .If the problem 
persists or happens often, call H&W Customer 
Support. 

606 

GIGS 


A dynamic memory allocation (GETMAIN) for the 
MVS CSAJQMOE failed. 

Increase the size of the MVS ECSA in your IPL 
parameters. 

606A, 606B 

GIGS 

SYSD0071 

The JES2 HCT/KIT information was not in the 
correct format 

Make sure the correct version of JES2 was specified 
for the &JES2VER parameter and the correct JES2 
libraries were used in the assembly procedures. 

607A 

GIGS 

SYSD0071 

The JES2 HCT/KIT information was not in the 
correct format. 

Make sure the correct version of JES2 was specified 
for the &JES2VER parameter and the correct JES2 
libraries were used in the assembly procedures. 

608 

GIGS 

SYSD0070 

SYSD0070 tried to get an area out of GSA or ECSA 


to store the JES2 checkpoint information. 

You have two options. First, increase the amount of 
ECSA. See your OS systems programmer. Second, 
use OSGORE instead of ECSA. To do this, change 
the checkpoint dataset read mechanism by setting 
the &JES2SRB parameter in SYSDSETS is set to 01 


164 


CPMS®iSYSD^ ~ Release 6.4.2 



Appendix H ~ System Abends and: Error Codes 


Abend'codk 

Abend: type Issued'by 

Reason/Gorrective actibni 

608,608A, 

608B;608D, 

608E 

GIGS 5^SD0071 

SYSD0071 tried to dynamically allocate memory 
(GETMAIN) for an OSCORE area to store JES2 
information and not enough OSGORE was 
available. 

Issue the JES2FREE command to release the 
GICS/OSGORE. If the problem persists, increase 
the OSCORE parameter of the DFHSIT. If 
increasing OSGORE restricts the GIGS dynamic 
storage area, you may also have to increase the 
region size. 

609 

GIGS 

SYSDOOOO did not enqueue on the SYSDOSTK 
resource within 6 minutes. SYSDOOOO enqueues the 
resource to create (attach) the auxiliary tasks. 

Make sure SYSDOSTK is in the STEPLIB library for 
GIGS. 

610 

GIGS 

The JES spool read request could not find the 
expected first, intermediate, or last segment of a 
spanned record. 

Correct the invalid JES records or control blocks 
that manage the spool dataset. If the problem 
persists, call H&W Customer Support. 

611, 611A 

GIGS 

SYSD could not verify the existence of the JES2 

DEB for the spool and checkpoint datasets. 

Make sure the correct JES2 and GIGS libraries were 
used to assemble SYSD0104. 

611B 

GIGS 

CPMS/SYSD could not find a JES2 subsystem that 
matched the &JES2JBI specification. 

Check the &JES2JBI parameter in SYSDSETS. If a 
secondary subsystem was specified, make sure it is 
running before GPMS/SYSD tries to use it. 
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Abend codd 

Abend i type tssuedby 

Reason/Gorrective actibm 

611G 

CICS 

GPMS/SYSD could not find the DSGB for the 
checkpoint dataset 

Make sure the correct JES2 and CICS libraries were 
used to assemble SYSD0071 and SYSD0038. 

612 

CICS 

SYSD emulated a skip^to-channel command for an 
FCB> but could not find the channel in the FGBi 

Make sure the correct FCB was specified for 
printing. If it was, update the FCB to indicate the 
position for the channel requested. 

613 

GIGS 

One of the spool print programs found a buffer 
overflow condition while outputting data. 

If the problem persists, call H&W Customer 

Support. 

615 

CICS 

The buffer size defined in the SYSDPTBL printer 
table exceeded the maximum buffer size specified 
in the printer's TGTTE. 

Make sure the buffer size in SYSDPTBL is less than, 
or equal to the buffer size specified in the TGTTE 
for the printer. 

616 

CICS 

SYSD0070 could not find the IES2 ASGB; 

Check the &IES2JBI parameter in SYSDSETS. If a 
secondary subsystem was specified, make sure it is 
running before CPMS/SYSD tries to use it 

617 

CICS 

GPMS/SYSD could not find the SSCT. 

Make sure the subsystem interface was installed in 
the Subsystem Name Table (SSNT) correctly. See 
the &SYSDSSI parameter in SYSDSETS. 

618 

GIGS 

GPMS/SYSD called the JES201 or JES203 user exit 


and the pointer to the job's JCT was incorrect 

If the problem persists, call H&W Customer 
Support. 
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Abend codb Abend type Issued by His^son/dorirecdve actioni 


619 


A read VO error occurred while reading the spool 
or job queue datasets. 


620 CICS 


If the problem persists, call H&W Customer 
Support. 


A spool print program found that the originating 
terminal ID and the printer table forms change 
terminal ID were blank. 


Make sure a valid forms change terminal exists for 
the printer in SYSDPTBL. If you are using 
auto-installed terminals, review the information for 
the &FORMMSG parameter in SYSDSETS. If the 
problem persists, call H&W Customer Support. 


622 CICS 


The spool print program found a UCS with an 
invalid length. 

Make sure your UCS is not larger than 255 bytes in 
length. 


CICS OPTS=SCSCMP was specified for a printer and 

the SCS horizontal tab setup commands failed. 

Use the OPTS=RTACMP parameter instead of 
OPTS=SCSCMR See the OPTS parairieter on page 
127 for more information. 


CICS OPTS=SCSCMP was specified for a printer and a 

compression error was found. 

Use the OPTS=RTACMP parameter instead of 
OPTS=SCSCMR See the OPTS parameter on page 
127 for more information. 


625 CICS 


OPTS=RTACMP was specified for a printer and a 
compression error was found. 


Remove the OPTS=RTACMP parameter from the 
printer entry. See the OPTS parameter on page 127 
for more information. 
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Abendcodb 

Abend) type Issued) by 

Reason/Corrective action 

626 

CICS 

The number of the JQH/JOE had been changed. 

This is the result of a cold start of JES2. 

Issue the JES2FREE command. 

700 

Gies 

There was not a PPT entry for a GPMS/SYSD SRB 
routine. 

Make sure you assembled the PPT entries for 
GPMS/SYSD to CIGS's PPT. 

701 

CICS 

There was not an object code for a GPMS/SYSD' 

SRB routine. 

Make sure the SYSDSRBl and SYSDSRB21oad 
modules in SYSD.LOADLIB are all right. If the 
problem persists, call H&W Customer Support. 

702 

GICS 

GPMS/SYSD ran out of the MVS CSA memory 
needed to run a GPMS/SYSD SRB routine. 

Increase the size of MVS CSA in your IPL 
parameter or turn off the JES2SRB) mechanism. See 
the &JES2SRB’parameter in SYSDSETS for more 
information. 

703 

GIGS 

An SRB routine returned an unsuccessful 
completion code. 

If the problem persists, call H&W Customer 

Support. 

750 

GICS 

SYSD could not find the function code SYSDINIT 
issued. 

If the problem persists, call H&W Customer 

Support. 

751 

GIGS 

GPMS/SYSD could not find the program for a 
requested SYSDINIT function code. 

If the problem persists, call H&W Customer 

Support 
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Abend! code 

Abend! type Issued! by 

Reason/Gorrective action! 

752 

CICS 

The requested SYSDINIT function code was 
disabled. 

The function was disabled during installation. See 
the person who installed CPMS/SYSD. 

753 

CIOS 

The conversational manager found an error while 
trying to write its temporary storage queue. 

Make sure you have defined enough auxiliary 
temporary storage in CICS. 

754 

GICS 

The conversational manager found an error while 
trying to find an element in temporary storage. 

If the problem persists, call H&W Customer 

Support. 

755 

CICS 

The conversational manager could not create a 
new function level. 

If the problem persists, call H&W Customer 

Support. 

756 

CICS 

The conversational manager found an unexpected: 

ID while reading an auxiliary temporary storage 
record. 

Make sure the CISIZE of your auxiliary temporary 
storage meets CPMS/SYSD's requirements. 

757 

CICS 

The help control stacks in SYSD0133 were full 

If the problem persists, call H&W Customer 

Support. 

758 

CICS 

The maximum levels of help in SYSD0133 were 
exceeded.. 

If the problem persists, call H&W Customer 

Support. 
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Abend cod<B 

Abend! type 

Issued! by 

Reason/Corrective actiom 

759 

CICS 


CPMS/SYSD tried to delete an empty help stack. 

If the problem persists, call H&W Customer 

Support. 

760 

CICS 


A read error occurred while trying to access the 
help file. 

Make sure the &HELPDSN parameter in 

SYSDSETS specifies the name of the SYSD help 
dataset and the dataset is cataloged. 

761 

CICS 

CMRTNS 

A swap partition member could not be found. 

If the problem persists, call H&W Customer 

Support. 

762 

CICS 

$LOeSBRT 

The beginning of the subroutines table couldhot 
be found. 

If the problem persists, call H&W Customer 

Support. 

763 

OS 

$UCBRTNS 

UGBLO OK returned a UCB address above the line. 
Theoretically, your operating system must be 

ESA 5.2 or OS/390 for UGBLOOK to return a UCB 
address above the line. 

Call H&W Customer Support for assistance. 

80A 

OS 


SYSD could not dynamically allocate memory 
(GETMAIN) from the OSCORE area in CICS's 
region or partition. Use the formula in "Calculating 
CPMS/SYSD's Memory Rtequirements" on page 42 
to determine the size. 

Increase the OSCORE value in the SIT and 
re-execute CICS. 

900 

CICS 

SYSD1080 

SYSD1G80 generated this abend. 




Make sure you initialized the editor work file with 
the EDITINIT function. 
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Abend! codk 

Abend type 

Issued by 

Reason/Correetive action! 

901 

GICS 

SYSD1080 

A SLAM bitmap error was found in the editor. 

If the problem persists, call H&W Customer 

Support. 

990 

CICS 

$CHECK 

A SYNAD error occurred on a dynamic exception 
and a SYNAD exit had not been generated for the 
program. 

If the problem 1 persists, call H&W Customer 

Support. 

997 

CICS 

$EXCOS 

A required auxiliary task was unavailable. 

Make sure SYSDOSTK is in the STEPLIB library for 
CICS. If the problem persists, call H&W Customer 
Support. 

998 

CICS 

$EXCOS 

The auxiliary task abended while executing the 
current function. 

Make sure SYSDOSTKis in the STEPLIB library for 
CICS. Check the operating systern console output 
for additional information on the abend. 

If the problem persists, call H&W Customer 

Support. 

999 

CICS 

SYSD0038 

A relative track address (MTTR^ could not be 
converted to an actual track address (MBBCCHHR). 

If the problem persists, call H&W Customer 

Support. 

Fxx, 

OS 


The wrong SVC number was used. The last 2 digits 


of the abend code are the SVC number in 
hexadecimal. If this does not match the SVC 
number specified for the &SYSDSVC parameter in 
SYSDSETS, correct SYSDSETS and reassemble 
SYSDINIT. You may also need to rerun the 
STGIASM job to re-create the INSTSVC member so 
youi can reinstall the SVC using the correct SVC 
number. 
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IWORKmacro 146-147 
&ATRNID parameter 100 
&CICSREL parameter 100-101^ 
&;CMPNAME parameter 101 
(ScDETINDS parameter 102 
&DSLSREF parameter 102 
&DSRECAL parameter 102 
&EDTBLKS parameter 102-103 
&EDTENQT parameter 103 
&EDTSAVE parameter 103 
&FNCxxxx parameters 104 
&FORMCHG parameter 104 
&FORMMSG parameter 105 
&GLB#PDB parameter 105 
&GLBPDDB parameter 105,116-117 
&HELPDSA parameter 105 
&HELPDSN parameter 105 
&ITRNID parameter 106 
(SiJES2ARA parameter 106 
&:JES2JBI parameter 107 
&JES2SRB parameter 107 
&JES2VER parameter 108-109 
&JESDFTC parameter 109 
&JESDUMC parameter 109 
&JESDUMD parameter 110 
&JESEXPR parameter 110 
&JESJOBKI parameter 110 
&JESSBMT parameter 111 
&JESSUBO parameter 111 
&JESTYP parameter 111 
&LOGACTV parameter 111 
&LOGDEST parameter 111 
&MAXOSTK parameter 112 
&MAXSCAN. parameter 112 
&MROTNID parameter 112 
&MTRNID parameter 113 
&MXAUXSZ'parameter 113 
&NPAGCMD parameter 113-114 
&OSLEVEL parameter 114' 
&OSTYP parameter 115 


&PERANL parameter 115 
&PQAUTO parameter 115 
&PRNTACQ parameter 116 
&PROC001 parameter 116 
&PRGC002 parameter 116 
&PROC003 parameter 
&PTBL macro 121-129 
&RPAGCMD parameter 117 
&SDDFTCL parameter 117 
&SPGTNID parameter 118 
&STDFCB parameter 118 
&STDFORM parameter 118 
&SVCNO parameter 119 
&SYSDATP parameter 119-120 
&SYSDSS1 parameter 120 
&UCBDYN parameter 120 
&USESYSN parameter 120 


A 

Abends, system 161-171 

Accounting information for JOB cards 86 

AGCTK) parameter 86 

Acquiring printers 116 

Active buffers for master console 58 

Adding 

initial user profile 28-29 

OSCORE memory 112 

user profiles 38-39 
Administering CPMS/SYSD 57-72 
Advanced security 32-33 
AIDLIMT parameter 123 
Alternate main CPMS/SYSD transaction ID 100 
Alternate online help dataset 105 
AMODGEN parameter 86-87 
Application Program Interface 46-47 
Archived datasets, authorizing users for restore 102 
ASMPROG parameter 87 
Assembler program for assembly PROCs 87 
Assembler translator, CICS command-level 88 
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Assemblies, installatioii. 19 
Assembly listings 93 
Assembly procedures 95 
Assembly PROCs 

assembler program.for 87 
creating during installation 19 
ATP (Access to CA-Panvalet) 

See SYSD/ATP' 

ATP dataset member table 
building 59 
updating 59 
ATPTBL command 59 
Auto-initiate transaction ID, GICS 106 
Auto-start printers, starting 115 
Automatically starting printers 123 
AUTOSTR parameter 123 
Auxiliary storage, maximum size 113 
Auxiliary tasks, checking status 66-67 


B 

Basic security 32 
Batch,Work File utility 73-79 
Beginning separator pages 128 
Bit, default system program 102 
Block size, editor work files 102-103 
BMS maps 

CPMS/SYSD Ubrary 97 
BMS paging commands 
first 117 
next, 113-114 

Browse datasets, securing 33 
Browse facility, overview 2 
Browse work files 

controlling from batch 73-79 
creating during installation 25 
dataset names 88 
defining 147 
initializing 55,60-61 
initializing during installation 28 
using multiple 56 
volume serial number 87 
BRSEXTOl user exit, 147 
BRWSMAIN dataset 147 
BRWSVOL parameter 87 
BRWSWRK parameter 88 
Buffering, minimizing in GIGS and VTAM 124 
Buffers, displaying active for master console 58 
Buffers, printer . 
delay between 124 
size 123 

BUFSIZ parameter 123 


Building ATP dataset member table 59 
Bypassing security checking for functions 32 



c 

CA-Panvalet 
See SYSD/ATP 

Carriage control, displaying 117 
Carriage size, printers 124 
CARSIZ parameter 124 
Checking 

GICS security keys 32 
status of auxiliary tasks 66-67 
user profile security 33 
Checkpoint dataset read method 43,107 
CHGTERM parameter 124 
CHKRESP parameter 124 
CICS 

acquiring printers 116 

activating IBM Performance Analyzer (PA) 115 

auto-initiate transaction ID 106 

calculating CPMS/SYSD memory requirements 42-43 

checking security keys 32 

command-level assembler translator 88 

debugging aids, overview 3 

defirute response writes 124 

internals management facilities, overview 2-3 

invoking CPMS/SYSD from user programs 46-47 

load library 89 

macro library 88 

maximum number of OS subtasks 112 

miitimizing buffering 124 

outstanding START commands 123 

passing control to CPMS/SYSD from programs 46-47 

preparing for installation 21,25-26 

requirements 21 

shutting down 45-46 

source library 89 

supporting large screens 46 

supporting MRO 47-48 

system definition file for RDO 88 

troubleshooting SVC errors 49 

updating JCL 25-26 

upgrading after installing CPMS/SYSD 44-45 
using multiple regions 43-44 
version 100-101 
GIGS tables 

creating copybooks 22 
CICS-dependent programs 
cop 3 dng source 19 
GICSCLA parameter 88 
GIGSCSD parameter 88 
CICSMAC parameter 88 
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CIGSOBJ parameter 89 
CICSSRC parameter 89 
CLASS parameter 89 
Classes 

default dummy, JES3 109 
execution, stage 1 processing jobs 89 
Command^level assembler translator, CICS 88 
Commands issued from Option L, securing 58 
Company name, defining for screen titles 101 
Compression procedure, PDSs 116 
Control blocks, displaying JES2 64 
Controlling work files from batch 73-79 
Conventions, syntax xii-xiii 
COPY function, batch 79 
Copybooks 

creating for CICS tables 22 
overriding standard CPMS/SYSD libraries 97 
Copying work files from batch; 79 
CPMS 

See also CPMS/SYSD 
hot writers, overview 4-5 
JOE writers, overview 4-5 
overview 4-5 

Spool Print facility, overview 4 
CPMS/SYSD 

administering 57-72 

alternate main transaction ID 100 

BMS map library 97 

calculating memory requirements 42-43 

global system parameters 104 

installing 9-29 

invoking from user programs 46-47 

issuing CICS definite response writes 124 

JES2 SRB queue read method 51 

load library 98 

macro library 97 

main transaction ID 113 

overriding standard libraries 97 

overview. 1-7 

passing control from programs 46-47 

running with secondary JES2 subsystem^ 51 

security ^ 32-33 

shutting down GIGS 45-46 

signing on 29 

source library 98 

STAGEl parameters 85-98 

starting 65 

supporting large screens 46 
supportingMRO 47-48 
SYSDSETS parameters 99-120 
testing installation 27 
troubleshooting S¥C errors 49 
upgrading CICS after installation; 44-45 
upgrading JES2 after instaUation 52 
upgrading MVS after installation 50 


user source library 98 
using multiple CICS regions 43-44 
verifying installationprocess 68 
Creating 

ATP dataset member table 59 
work files from batch 79 
CSA area, getting MVS 106 
CSDLIST parameter 90 
Customizing security exits 29 


D 

DASD management facUities, overview 2 
Dataset member table, building ATP 59 
Dataset names 

alternate online help 105 
browse work file 88 
editor work files 91 
JES2 macro 92 
JES2 source 92 
JES3 macro 92 
JES3 source 92 
main online help 105 
PROC library 95 

Dataset type enqueues, editor 103 
Datasets 

management facilities, overview 2 
updating last reference date 102 
Datasets, archived 

authorizing users for restore 102 
Datasets, displaying SYSIN 120 
Datasets, partitioned 

compressionprocedure 116 
print procedure 116 
Datasets, using JES 51 
DCAAZN label, invalid 115 
DCT name for submitting jobs through editor 111 
DCT submit entry, leaving open after submitting jobs 
111 

Debugging aids, CICS 3 
Definite response writes, GIGS 124 
Delay between printer buffers 124 
DELAY parameter 124 
Deleting user profiles 39 
DEST parameter 91 

Destinations, stage 1 processing jobs 91 
DFTDISP parameter 124-125 
DFTFGB parameter 125 
DFTRCLS parameter 125 
DFTRDST parameter 126 
DFTSCLS parameter 126 
DFTSDST parameter 126 
DFTSFRM parameter 126 
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DFTSWTR parameter 126 
DFTUCS parameter 127 
Disabling functions 32,131-137 
Displaying 

active buffers for master console 58 
carriage control 117 
edit sessions in work;files 62-63 
JES2 control blocks for jobs 64 
program,statistics 59-60 
PTBLMAIN parameters 122 
SYSIN, datasets 120' 

TCT 70-71 
Distribution files 
CPMS/SYSD 13-14 
SYSD/JFT 81 

Distribution libraries^ unloading 13-15 
DP command 59-60 
DPROG command 59-60 
DSNOOl user exit 33 
DSN002 user exit 33 
Dummy class, JES3 109 
Dummy destination, JES2 110 
Dynamic UCBs 120 

Dynamically assigning function ID for TEST 
command 72 

Dynamically loading new copy of 
SYSD0005 68 
SYSD0074 69 
SYSD0137 69 
SYSD0174 69 


E 

ECSA area, getting MVS 106 

ECSA feature, implementing during installation; 18 

Edit datasets, securing 33 

Edit sessions 

creating intermediate fUes from batch 76-78 
creating reports from batch 76-78 
creating totals report from batch 76-78 
getting information about outstanding 76-78 
processing intermediate files from batch 76-78 
summary of 62-63 

updating with RETURN command 103 
EDITINIT command 60-61 
EDITINIT function, 

initializing work files during installation 28 
initializing work files from.batch. 75 
EDITLIST command 62-63 
EDITLIST function, batch, 76-78 
Editor 

dataset type enqueues 103 
DCT name for submitting jobs 111 


overview 2 
Editor work files 
block size 102-103 
controlling from batch 73-79 
creating during installation 25 
dataset names 91 
defining 146 
initializing 53-54,60-61 
initializing during installation 28 
using multiple 54 
volume serial number 91 
EDITVOL parameter 91 
EDITWRK parameter 91 
EDTEXTOl user exit 146 
El command 60-61 
El function; batch 75 
EL command 62-63 
EL function, batch 76-78 
Ending separator pages 129 
Enqueue types, editor dataset 103 
Error codes 161-171 
Errors 

EDITINIT command 60-61 
SVG 49 

Execution class, stage 1 processing jobs 89 
Exits, security 
customizing 29 
SYSLOl 58 
Exits, user 
BRSEXTOl 147 
DSNOOl 33 
DSN002 33 
EDTEXTOl 146 
FUNCOl 32,134 
JES201 33 
JES202 33 
JES203 33 
JES206 33 
JES207 33 
MENU02 32,134 
MENU03 33 

overriding standard CPMS/SYSD libraries 97 
summary of 142-144 




F 

Files, distribution 
summary of 13-14 
First page command, BMS 117 
Forms change message, sending 105 
Forms change requests, initial 104 
Forms change terminal, sending messages to 105 
Forms control buffers (FCBs) f 
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defaults 41,118,125 
overriding defaults 41,118,125 
setting vertical tabs 128 
using with spool print 41 
Forms, default for OS printers 118 
Freeing JES2 internal areas 63 
FUNCOl user exit 134 

checking CICS security keys 32 
setting up security for functions 32 
Function ID for TEST coirunand, dynamically 
assigning 72 
Functions 

bypassing security checking 32 
disabling 32 

global system parameters 104 
setting up security for resources 32 
testing new 72 

Functions, system programmer 
authorizing users for 102 


G 

Global JOE writer scanning task, 
starting 65 
stopping 65 
Global PDDB table 

minimum number datasets in job 105 
using 105,116-117 
Global system parameters 104 


H 

Held jobs, dummy class 109 
Help, online 

alternate dataset 105 
main dataset 105 
securing 32 
Hot writers 

new class after printing output 125 

new destination after printing output 126 

overview, 4-5 

scan class 126 

scan,delay 128^ 

scan destination 126 

scan form 126 

starting 64 

SYSOUT dispositions 124-125 


I 

IBM macro library, overriding 96 
IBM Performance Analyzer (PA), activating 115 
Increasing size of work files from batch; 79 
Initial forms change request 104 
Initializmg 

browse workfiles 55,60-61 
browse work files during instaUationi 28 
editor work files 53-54, 60-61 
editor work files during installation 28 
work files from batch 75 
INITMAIN parameters 131-137 
adding security checking 32-33 
Installation 
testing 27 
verifying 68 

Installation parameters and JCL, summary of 

members 140-141 

Installing 

CPMS/SYSD 9-29 
SVGs 18 
SYSD/ATP 21 
SYSD/JFT 81-84 
INSTATE running 21 
INSTCOPY, running 19 
INSTGTBL, running 22 
INSTFILE, running 24 
INSTPROC, running 19 
INSTPROG, running 20 
INSTSVC, running 18 
Internal areas, freeing JES2 63 
Introduction 1-7 

Invoking CPMS/SYSD from user programs 46-47 


J 

JCL 

Batch Work File utility 74 
summaiy of installation members 140-141 
updating CICS 25-26 
JES 

datasets, using 51 

DCT name for submitting jobs through editor 111 

default FCBs 118 

default form 118 

default route dass 109 

dummy class, JES3 109 

dummy destination, JES2 110 

job name 107 

JQE/JOE update expiration time 110 
submit option flag 111 
used 111 
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JES2 

displaying control blocks for jobs 64 
dummy destination 110 
freeing internal areas 63 
getting checkpoint information 107 
getting MVS GSA area 106 
JES job name 107 

JQE/JOE update expiration time 110 
OS JES job name 107 
running secondary subsystem 51 
secondary subsystem name 107 
source and macro dataset name 92 
upgrading after installing CPMS/SYSD 52 
using MVS Spool Display facility 40 
using VSAM interface to submit jobs 110 
version 108-109 
JES2 SRB queue read method 
activating 18 

calculating memory requirements 43 
getting checkpoint information 107 
getting MVS CSA area 106 
using 51 

JES201 user exit 33 
JES202 user exit 33 
JES203 user exit 33 
JES204 user exit 

beginning separator pages 128 
ending separator pages 129 
JES206 user exit 33 
JES207 user exit 33 
JES2FREE command 63 
JES2LJOB command 64 
JES2SRC parameter 92 
JES3 

dummy class for held jobs 109 
source and macro dataset name 92 
JES3SRC parameter 92 
JET (Job and File Tailoring) 

See SYSD/JFT 

JOB carddefault accounting information 86 
JOB cards, stage 1 processing jobs 
execution class 89 
priority 94 

programmer name 94 
region size 96 

Job names, default for stage 1 processing jobs 92 
JOBNAME parameter 92 
JOBPARM parameter 93 
Jobs 

displaying JES2 control blocks 64 
leaving DOT entry open after submitting 111 
submitting with VSAM interface 110 
Jobs, held 

default dummy class 109 
Jobs, managing spool 40 


JOE writer scanning task, outstanding GIGS START 
commands 123 
JOE writers 

maximum scan interval 112 

new dass after printing output 125 

new destination after printing output 126 

overview 4-5 

scan dass 126 

scan destination 126 

scan form 126 

scan writer name 1!^ 

starting 65-66 

starting global scanning task 65 
stopping global scanning task 65 
SYSOUT dispositions 124-125 
JOEs, update expiration time 110 
JQEs, update expiration time 110 


K 

Keyboard conventions xii 


L 

Last reference date, datasets 102 
Libraries 
GIGS load 89 
GIGS macro 88 
GIGS source 89 
GPMS/SYSD BMS map 97 
GPMS/SYSD load 98 
GPMS/SYSD macro 97 
GPMS/SYSD source 98 
GPMS/SYSD user source 98 
OS SVG 97 

OS system source 86-87,93 
overriding IBM macro 96 
overriding standard GPMS/SYSD 97 
PROG 95 

unloading distribution, 13-15 
List name for SYSD resources, RDO 90 
LIST parameter 93 
Listings, assembly 93 
Load libraries 
GIGS 89 
GPMS/SYSD 98 
Load modules 
SYSDBRWS 147 
SYSDWORK 146 



^^ 
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Loading new copy, dynamically 
SYSD0005 68 
SYBD0074 69 
SYSD0137 69 
SYSD0174 69 
Logging 

system changes 111 
transient data destination. 111 


M 

Macro dataset names 
JES2 92 
JES3 92 
Macro library 
CICS 88 
CPMS/SYSD 97 
overriding IBM 96 
Macros 

$PTBL 121-129 
$WORK. 146-147 

overriding standard CPMS/SYSD libraries 97 
SYSDTABL 131-137 
Main.CPMS/SYSD transaction ID 113 
alternate 100 

Maintaining user profiles 34-39 
Managing 

CICS internals, overview 2-3 
DASD, overview 2 
datasets, overview 2 
spool space and jobs 40 
Manual organization x-xi 
Map library,.CPMS/SYSD BMS 97 
Maps, BMS 

CPMS/SYSD library 97 
Master console, displaying active buffers 58 
Master terminal for printers 127 
MASTERM parameter 127 
MAXLIN parameter 127 
Members in SYSD.USRLIB 139-144 
Memory requirements 
calculating 42-43 
checkpoint read method 43 
SRB queue read method 43 
Memory, adding OSCORE 112 
Menu:system, securing 32 
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Next page command, BMS 113-114 
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Online help 
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SVC library 97 
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sending to new destination after printing 126 
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Overriding 

default FCBs 41,118,125 
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standard CPMS/SYSD libraries 97 
Overview 1-7 
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default JOBPARM 93 
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STAGEl 85-98 
SYSDSETS 99-120 
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summary of members 140-141 
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compression procedure 116 
print procedure 116 
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acquiring 116 
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PRIO parameter 94 
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Program modules, summary of 149-159 
Programmer name, stage 1 processing jobs 94 
Programs 

displaying statistics 59-60 
passing control to CPMS/SYSD 46-47 
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PRTDSP function 122 
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starting 65 
stopping 65 
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Screens 
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User File Maintenance 34-39 
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Securing 
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online help 32 
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SYSLOl 58 
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Source dataset names 
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JES3 92 
Source libraries 
CICS 89 
CPMS/SYSD 98 
CPMS/SYSD user 98 
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using 51 

Stage 1 processing 
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execution class 89 
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JOBPARM parameters 93 
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START command 65 
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auto-start printers 115 
CPMS/SYSD 65 
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hot writers 64 

JOE writers 65-66 
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Statistics, displaying program 59*60 
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STPSCN command 65 
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using VSAM interface 110 
Subsystem interface entry, updating during 
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edit sessions 62-63 
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program modules 149-159 
SYSD.USRLIB members 139-144 
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Supporting 
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MRO 47-48 
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SWST command 65-66 
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SYSD 

See also CPMS/SYSD 
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default SVC 119 
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overview 2-3 
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SYSD.USRLIB 
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SYSDSRG parameter 98 
SYSDTABL macro 131-137 
SYSDTASK command 66-67 
SYSDTEST command 68 
testing installation 27 
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SYSDUSR parameter 98 
SYSDWORK load module 146 
SYSDWRKO file 
creating during installation 24 
initializing during installation 28 
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SYSLOl security exit 58 
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SYSPGMR command 69 
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System changes, logging 111 
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System program bit, default 102 
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TRMDEST parameter 129 
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Update expiration.time, JQE/JOE 110 
Updating 
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CICSJCL 25-26 
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summary of 142-144 
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setting up initial 28-29 
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